MICROSOFT WINDOWS 2.0 
SOFTWARE DEVELOPMENT KIT 


UPDATE 


This update to the Windows 2.0 Software Development Kit documentation 
contains descriptions of new software features along with changes to 
descriptions for some existing features. 


Several areas of the printed documentation -- particularly Programming Tools 
-- have been rewritten to make them clearer. 


Conventions Used in This Update 


Underscored text is new or has changed. For example: 


Pay attention to underscored text: it's either new text or changes to the old 
text, 


Text that should be deleted from the manuals is marked as follows: 


[DELETE: "Delete text contained within bolded quotes and brackets." ] 
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Update Contents 


This update contains information regarding the following sections of the 


manuals: 


Microsoft Windows Programmer's Reference 


CHAPTER 2: "Functions Overview" 
Printer Escape Functions 


CHAPTER 3: "Functions Directory" 
(Functions are listed alphabetically) 


CHAPTER 5: "Messages Directory" 
(Messages are listed alphabetically) 


CHAPTER 6: "Data Types and Structures" 
(Data types and structures are listed alphabetically) 


CHAPTER 7: "File Formats" 
Font File Format 
Metafile Format 


APPENDIX C: "Printer Escapes" 
BANDINFO 
NEXTBAND 


Microsoft Windows Programmer's Learning Guide 


CHAPTER 3: "A Sample Application: Generic" 
Create the C-Language Source File 


CHAPTER 4: "Output to a Window" 
Creating, Selecting, and Deleting Drawing Tools 
Drawing and Writing 
Modify the WM_CREATE Case 
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CHAPTER 7: "The Cursor, the Mouse, and the Keyboard" 
Using the Keyboard to Move the Cursor 
Add a Lengthy Operation _ 
Add the WM_KEYDOWN Case 


CHAPTER 8: "Menus" 
Add an Edit Menu to the Resource File 


CHAPTER 9: "Bitmaps" 
Modify the Make File 


CHAPTER 10: "Controls and Dialog Boxes" 
Moving and Sizing a Control 
Add a Constant to the Include File 
Creating a Dialog Function 


CHAPTER 12: "Printing" 
Add the EDM_PRINT Case 


CHAPTER 13: "The Clipboard" 
Selecting and Copying Bitmaps to the Clipboard 
Modify the WM_INITMENU Case 


APPENDIX A: "Fonts" 
Creating a Logical Font 
Getting Information About the Selected Font 
Creating Font-Resource Files 


APPENDIX B: "Memory Management" 


Using the Local Heap 
The DATA Segment 
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Microsoft Windows Programming Tools 


CHAPTER 2: "Cl, Pascal, and the Macro Assembler" 
Segment Names 
Stack Probes 
Packed Structures 
Windows and C-Language Libraries 
C Run-time Functions 
Coprocessor/Emulator Math Option 
Alternate Math Option 


CHAPTER 3: "Resource Compiler: Rc" 
Introduction 
Compiling Resources 
ACCELERATORS Statement 
STYLE Statement 


CHAPTER 4: "Windows Linker: Link4" 
Introduction 
Linking an Application 
Link4 Command 
Link4 Options 


CHAPTER 5: "Symbolic Debugging Utility: Symdeb" 
Symdeb Commands 
Breakpoint Address Command 


CHAPTER 8: "Icon Editor" 
Starting Icon Editor 
Choosing Resolution 
Working with Bitmaps 
Driver Dependence 
Changing the Pen Color 
Small 
Medium, Large, and Extra Large 
Changing the Background Color 
Using the Options Menu 


« 4 » 


MICROSOFT WINDOWS 2.0 SDK UPDATE 


CHAPTER 10: "Dialog Editor" 
Starting Dialog Editor 
Using the Status Window 
Clearing the Display 
Adding Text to Controls 
Moving a Group of Controls 
Changing Control Styles and Memory-Manager Flags 
Changing Control Styles 
Changing Standard Styles 
Including a System-Menu Box, a Size Box, or Scroll Bars 
Setting Memory-Manager Flags 
Changing the Order of Controls 
Setting a Tab Stop 
Deleting a Tab Stop 
Adding a Group Marker 
| Deleting a Group Marker 
Using the Edit Menu 
Include File ee 


CHAPTER 11: "Shaker and Heapwalker" 
Testing Movable Memory; Shaker 
_ Viewing the Global Heap: Heapwalker 


NEW CHAPTER 12: "Snap" 


Microsoft Windows Extensions 


NEW APPENDIX B: “Write File Format" 
| . NEW APPENDIX C: "Paint File Format" 


NEW APPENDIX D: "Calendar File Format" 
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Microsoft Windows Programmer's Reference 


CHAPTER 2 [Pages 21-143]: 
Functions Overview 


Printer-Escape Functions _ [Section 2.3.14; page 130) 


(DELETE: 
./ "EXTTEXTOUT Provides a more efficient way for the application to call the 
GDI TextOut function." J 


CHAPTER 3 [Pages 147-501]? 
Functions Directory 


* ATOM AddAtom(pSztring) 
Comments 


The atom values returned by Add Atom range from CO00 to FFFF 
vi (hexadecimal). Atoms are case insensitive 
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LPSTR AnsiLower(/pStr) 

Return Value 

The return value points to a converted character string if the function parameter 
is a character string. Otherwise, it is a 32-bit value that contains the converted 


character in the low-order byte of the low-order word[DELETE:", and the 
high-order word is zero" ]. 


LPSTR AnsiUpper(/pStr) 

Return Value 

The return value points to a converted character string if the function parameter 
is a character string; otherwise, it is a 32-bit value that contains the converted 


character in the low-order byte of the low-order word[DELETE:", and the 
high-order word is zero" J. 


HWND CreateDialog(hInstance, lpTemplateName, hWndParent, 
[pDialogF unc) 


Return Value 


The return value is the window handle of the dialog box. It is -1 if the function 


cannot create the dialog box. 
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* TIWND CreateDialogIndirect(hinstance, [pDialogTemplate, 
hWndParent, lpDialogF unc) 


Return Value 


The return value is the window handle of the dialog box. It is NULL if the 
function cannot create either the dialog box or any controls in the dialog box. 


* HWND CreateWindow(rgbColor) 


Table 3.5 
Control Styles 


Style Meaning 
STATIC Class 


SS NOPREFIX Unless this style is specified, windows will interpret any 
"&" characters in the control's text to be accelerator prefix 
characters. In this case. the "&"' is removed and the next 
character in the string is underlined. If a static control is to 
contain text where this feature is not wanted, 

SS NOPREFIX may be added, This static-control style 
may be included with any of the defined static controls. 


You can combine SS NOPREFIX with other styles by 


ing the bitwi R operator. This is most often used 
when filenames or other strings that may contain an "&" 
need to be displayed in a static control in a dialog box, 
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int DialogBox(hinstance, lpTemplateName, hWndParent, IpDialogF unc) 
Return Value 


The return value specifies the value of the nResult parameter in the EndDialog © 
function that is used to terminate the dialog box. Values returned by the 
application's dialog box are processed by Windows and are not returned to the 
application. The return value is -1 if the function could not create the dialog 
box. — 


int DialogBoxIndirect(hinstance, hDTemplateName, hWndParent, 
[pDialogFunc) 


Return Value 


The return value specifies the value of the wResult parameter in the EndDialog 
function that is used to terminate the dialog box. Values returned by the © 
application's dialog box are processed by Windows and are not returned to the 
application. The return value is -1 if the function could not create the function. 


WORD EnumClipboardFormats(wFormat) 
Return Value 


The return value specifies the next known clipboard data format. It is zero if 
wFormat specifies the last format in the list of available formats. It is zero if 


Clipboard is not open, 


Comments 


The order that an application uses for putting alternative formats for the same 
ta into the Clipboard is th e order that the enumerator when 


- returning them to the pasting application. The pasting application should use the 
first format enumerated that it can handle. This gives the donor a chance to 


recommend formats that involve the least loss of data. 
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* BOOL ExtTextOut(hDC, X, Y, wOptions, IpRect, lpString, nCount, IlpDx) 


a 


a 


Parameter 


wOptions 


T ription 


WORD Specifies the rectangle type. It can be one or 
both of the following values, or neither: 

ETO_CLIPPED 

ETO_OPAQUE 

The ETO_CLIPPED value specifies that Windows will clip 
text to the rectangle. The ETO_OPAQUE value specifies 
that the current background color fills the rectangle. 


BOOL FillRen(hDC, hRen, hBrush) 


Par ameter 


hRen 


Type/Description 


HRGN Identifies the region to be filled. The coordinates 
for the given region are specified in device units. 


BOOL FrameRgn(hDC, hRen, hBrush, nWidth, nHeight) 


Parameter 
hRen 


T ripti 
HRGN Identifies the region to be enclosed in a border. 


The coordinates for the given region are specified in device 
units. 
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* Jong GetBitmapBits(hBitmap, dwCount, IpBits) 


Parameter T ription 
é | IpBits LPSTR Long pointer to the buffer that is to receive the 
© bitmap. The bitmap is an array of bytes._The bitmap byte 
| | array conforms to a structure where horizontal scan lines 


are multiples of 16 bits. 


| * WORD GetWindowWord(hWnd, nIndex) 
Parameter Type/Description 
Value Meaning 


GWW_HWNDTEXT 

| Handle to the window title, but this 

| @ | handle is not accessible tothe  —> 
N application. 


* HANDLE GlobalDiscard(hMem) 


Comments 


The GlobalDiscard function discards only global objects that an application 
allocated with the (DELETE: "GMEM_ DISCARDED" ] | 
GMEM_DISCARDABLE and GMEM_ MOVEABLE flags set. The function 
| fails if an application attempts to discard a fixed object. 
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void GlobalNotifv(/pNotifvProc 


This function installs a notification procedure for the current task. 
Parameter Type/Description 


IpNotifvProc FARPROC _ This is the procedure instance address of the 
current task's notification procedure. 


mmen 


The address passed as the [pNotifvProc parameter must be created by using the 
MakeProcInstance function. A notification procedure is called whenever a 
global memory block allocated with the GMEM NOTIFY flag is about to be 
discarded. 


If the notification procedure retums a non-zero value, Windows discards the 
global memory block. If zero is returned, the block is not discarded. 


The notification procedure must use the Pascal calling convention and must be 
declared FAR. The notification procedure must have the following form: 


BOOL FAR PASCAL NotifyProc (hmem) 
NotifvProc is a placeholder for the application-supplied function name. Export 


enam including it in an EXPORTS statement in the application's module- 
definition statement. 
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Parameter Type/Description 

hMem HANDLE _ Identifies the global memory block being 
discarded. 

Return Value 


The function returns a non-zero value if Windows is to discard the memory 
block. and zero if it should not. 


* BOOL InvertRen(hDC, hRegn) 


Parameter Type/Description 
hRen HRGN Identifies the region to be filled. The coordinates 
for the region are specified in device units. 
e * HBITMAP LoadBitmap(hinstance, lpBitmapName) 
: Comments 
If a bitmap is device-independent, th Bi function stretches or 


compresses the bitmap to accommodate the system's aspect ratio and resolution. 
If a bitmap is device-dependent, it's loaded as is. without any transformation 

lied, Mark bitma device-independent or device-dependent when you 
create them with Iconeditor. 
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* HCURSOR LoadCursor(hinstance, lpCursorName) 
Comments 
[After "IDC_SIZE":] 
IDC SIZENESW Double-pointed cursor with arrows pointing northeast and 
southwest 


IDC SIZENS Double-pointed cursor with arrows pointing north and 
south 


IDC _SIZENWSE Double-pointed cursor with arrows pointing northwest and 
southeast 


ID IZEWE Double-pointed cursor with arrows pointing west and east 


* BOOL PaintRen(hDC, hRegn) 


Parameter Type/Description 
hRen HRGN Identifies the region to be filled. The coordinates 


for the given region are specified in device units. 


* void PlayMetaFileRecord(hDC, [pHandletable, IpMetaRecord, nHndl) 
Parameter Type/Description 


IpHandletable LPSTR Points to the object handle table to be used for 
the metafile playback. 


IpMetaRecord LPSTR Points to the metafile to be played. 
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HANDLE SelectObject(iDC, hObject) 


Return Value 


If aregion is being selected. the retu rm is the same as for SelectClipRgn. 


long SetBitmapBits(iBitmap, dwCount, [pBits) 


Parameter Type/Description 
[pBits LPSTR Points to the bitmap bits that are stored as a long 


pointer to a byte array. 


FARPROC SetWindowsHook(nFilterType, [pFilterFunc) 
Return Value 


The return value points to the procedure-instance address of the previously 
installed filter (if any). It is NULLif there is no previous filter. The library that 
calls the SetWindowsHook function must save this return value in the library's 
data segment. The fourth argument of the DefHookProc function points to the 
location in memory where the library saves this return value. 


Comments 


The system hooks are a shared resource. Installing a hook affects all 
applications. Because of LIM 4.0 considerations. most hook functions must be 
in libraries. The only exception is WH MSGFILTER, which is task-specific. 
System hooks should be restricted to special-purpose applications or as a 
development aid during debugging of an application. Libraries that no longer 
need the hook should remove the filter function. 
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To install a filter function, the SetWindowsHook function must receive a 
procedure-instance address of the function, and the function must be exported 


in the library's module-definition file. Libraries can pass the procedure address 
directly. Tasks must use MakeProcInstance to get a procedure-instance 


WH_CALLWNDPROC 
[Fourth paragraph: | 
FilterFunc is a placeholder for the library-supplied function name. The actual 


name must be exported by including it in an EXPORTS statement in the 
library's module-definition file. 


WH_GETMESSAGE 
[Third paragraph: ] @ 
FilterFunc is a placeholder for the library-supplied function name. The actual 


name must be exported by including it in an EXPORTS statement in the 
library's module-definition file. 


WH_JOURNALPLAYBACK 
[Fourth paragraph:] 
FilterFunc is a placeholder for the library-supplied function name. The actual 


name must be exported by including it in an EXPORTS statement in the 
library's module-definition file. | ¥ 
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WH_JOURNALRECORD 
[Fourth paragraph:] 
FilterFunc is a placeholder for the library-supplied function name. The actual 


name must be exported by including it in an EXPORTS statement in the 
library's module-definition file. 


WH_ KEYBOARD 
[Fourth paragraph: ] 
FilterFunc is a placeholder for the library-supplied function name. The actual 


name must be exported by including it in an EXPORTS statement in the 
library's module-definition file. 


WH _MSGFILTER 


[After first paragraph:] 


Note 


This is the only task- ific filter, A task may install this filter 


[Fourth paragraph: ] 
FilterFunc is a placeholder for the library- or application-supplied function 


name. The actual name must be exported by including it in an EXPORTS 
statement in the application's module-definition file. 
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WH_SYSMSGFILTER 
[Fourth paragraph:] 
FilterFunc is a placeholder for the library-supplied function name. The actual 


name must be exported by including it in an EXPORTS statement in the 
library's module-definition file. 


BOOL StretchBlt(hDestDC, X, Y, nWidth, nHeight, hSrcdc, XSrc, YSrc, 
nSrcWidth, nSrcHeight, dwRop) 


[DELETE: "StretchBlt cannot process bitmaps larger than 64K. If a bitmap 
is larger than 64K, it must be subdivided into smaller bitmaps." 


BOOL WriteProfileString(/pApplicationName, lpKeyName, IpString) 


This function copies the character string pointed to by the /pString parameter 
into the Windows initialization file, wiy.int. 


Parameter Type/Description 


lpApplicationName 
LPSTR Points to an application heading in win.ini. 


ipKeyName LPSTR _ Points to a key name that appears under the 
application heading in win.ini. 


IpString LPSTR __ Points to the string that should replace the 
existing key name. 
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Return Value 


The return value specifies the result of the function. It is nonzero if the function 
is successful, Otherwise, it 1s zero. 


Inmen 


If there 1s no match for [pKeyNam new string that /pString points to will 
be added to win.ini. 


If there is no match for IpApplicationName. this function creates a new 
lication field and adds the string pointed to by /pStrin 


A string entry in win.inih e following form: 


[application name] 
keyname = value 


CHAPTER 5 [Pages 517-604]: 
Messages Directory 


* EM GETHANDLE 


Comments 


You may use this message only if a DS LOCALEDIT flag has been added to 
the STYLE command for the dialog box in the .rc file. 
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* EM SETHANDLE 
Comments 


You may use this message only if a DS_LOCALEDIT flag has been added to 
the STYLE command for the dialog box in the .rc file. 


* LB SETCURSEL 


Parameter Type/Description 
wParam Contains the index of the string that is selected. If wParam 


is -1, the list box is set to have no selection. 


* LB SETSEL 


Parameter T ription 
[Param The low-order word of the /Param parameter is an index 


that specifies which string to set. If /Param is -1, the 
selection is removed from or added to all strings based on 
the value of wParam. 


id M_SP AT 


This message is sent from the spooler whenever a job is removed from the 
spooler's queue. 
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Parameter Type/Description 


wParam Is set to SP JOBSTATUS. 
Iparam Specifies the number of jobs remaining in the spooler's 
| queue. 


mmen 


This message is for informational purposes only. 


WM SYSCHAR 

Parameter Type/Description 

wParam Contains the ASCIl-character keycode of a system-menu 
key. 


CHAPTER 6 [Pages 605-636): 
Data Types and Structures 


DLGTEMPLATE Dialog Template 


Field Description 
dtResourceName[] 


Specifies a zero-terminated string that specifies the name of 


the dialog box's menu. 
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dtClassName[] Specifies a zero-terminated string that specifies the name of 


the dialog box's class name. If a standard dialog box is 
desired, it should be a one-byte NULL string. 


[After "dtilY", add a new field:] 


Field Description 
Cl m A zero-terminated string that specifies the control's class. It 


may be one of the following: 


BUTTON 
EDIT 
STATIC 
LISTBOX 
SCROLLBAR 


* LOGFONT Logical-Font Descriptor 


Field ription 
lfHeight Specifies the average height of the font (in user units). 
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CHAPTER 7 [Pages 637-660]: 
File Formats 


Font-File Format [Section 7.2; pages 644-645] 
Field ripti 
<bitmaps> This field contains the character bitmap definitions. Each 


haracter is stored as a contiguous set of bytes. (In the 
previous font format, this was not the case.) The first byte 
ntai first eight bits of the first scan line (that is, the 
top line of the character), The second byte contains the first 
eight bits of the second scan line. , 


This continues until what amounts toa first column is 
completely defined. The following byte contains the next 
eight bits of the first scan line, padded with zeroes on the 


right if necessary (and so on, down through the second 
column). 

If the font is quite narrow. each line is covered by on 
byte, with bits set to zero as necessary for padding, and if 
the font is very wide a third or even fourth set of bytes can 
be present. 

The ch r bitmaps mus or nti ] 


in ascending order. 
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Figure 7.1 gives the bytes for a 12x14 pixel character, shown schematically: 


ss * 2 82 8 8 &¢ @ 2 2 & 


eect 
faa ss @ oe ee x, 
oe oer ee ese ae 
eee 
SR RRKKKER 
~* soe RB ae @ Ke 
iat e¢*# @ on @ @ kL, 
k k 


ss so @® ®@ @ @€ @ @ @ 
eo. ®© © @ @ 2 & @ & 4 & 
> 2 @ @ Bee &@ ee PF 


soe, @ @ ee @® @ @ GC 42 8 8 


Figure 7.1 12x14 Pixel Character 


The bytes are given here in two sets, as the character is less than 17 pixels 
wide: 

00 06 09 10 20 20 20 3F 20 20 20 00 00 00 

00 00 00 80 40 40 40 CO 40 40 40 00 00 00 


Note that in the second set of bytes, the second digit of each is always zero. It 
would correspond to the 13th through 16th pixels on the right side of the 
character, if they were present. 


APPENDIX C [Pages 681-708]? 
Printer Escapes 


short Escape(hDC, BANDINFO, nCount, IpInData, lpOutData) 


This escape copies information about a device with banding capabilities to a 
structure pointed to by the JpOutData parameter. Banding is a property of an 
output device that allows a page of output to be stored in a metafile and divided 
into bands, each of which is sent to the device in order to create a complete 
page. Devices with banding capabilities avoid problems associated with 
devices that cannot scroll backward. 
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The information copied to the structure pointed to by JpQutData includes a 
value that indicates whether there are graphics in the next band, a value that 
indicates whether there is text on the page, and a rectangle structure that 
contains a bounding rectangle for all graphics on the page. 


The [pI ter specifies information sent by th lication to th 
device driver. This information is read by the device driver only on the first 
BANDINEFO call on a page. 


Parameter T ription 

[pOutData LPSTR Points to a data structure that contains the 
following items: 
Field ription 
fGraphFlag BOOL Specifies whether there are 


graphics on the page._It is nonzero if 


the driver expects graphics in the 
current band. Otherwise, it 1s zero. 


* short Escape(hDC, NEXTBAND, NULL, (LPSTR)NULL, /pBandRect) 


Comments 


The NEXTBAND escape sets the band rectangle to the empty rectangle when 


ou reach the end of a page. This indicates that you should issue a 
NEWFRAME call. 
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APPENDIX D [New appendix): 
Metafile Format 


A metafile consists of a collection of Graphic Device Interface (GDI) function 
calls that create specific images on a device. Metafiles provide convenient 
storage for images that appear repeatedly in applications, and also allow you to 
use Clipboard to cut and paste images from one application to another. 


Images are stored in metafiles as a series of GDI functions. After function 
calls are stored, applications play a metafile to generate an image on a device. 


Note 


Functions described in this section are discussed in greater detail in 
the Microsoft Windows Programmer's Reference. 


D.1 Using Metafiles 

These are the steps involved in using a metafile: 
1. Create the metafile. 

2. Enter the GDI functions in the metafile. 

3. Close the metafile. 

4. Retrieve the metafile. 


5. Play the metafile. 
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There are also functions available that allow you to retrieve metafiles from disk, 
delete them, copy them from one application to another, and alter them while 
they're being played. 

The above steps are described in the following sections. A sample metafile 
program is included at the end of this chapter. 


D.1.1 Creating a Metafile 


To create a metafile, use the CreateMetaFile function. This call returns a 
handle that is used like a regular Device Context handle (ADC). 


To create the image, make GDI calls as though to aregular DC. The only . 
difference is that the hDC that is passed into all the calls should be the handle 
returned by the CreateMetaFile function. 

The series of calls is then stored in the metafile. If a file is associated with the 
metafile, the calls are stored on disk for later use. If a memory metafile is being 
used, the calls are stored in main memory. 

D.1.2 Closing a Metafile 

When all of the needed calls are made, use the CloseMetaFile function to close 
the metafile. This tells the GDI that the metafile is complete and ready for 
playing. A metafile handle is returned by this function. 

D.1.3 Retrieving a Metafile 

Use the GetMetaFile function call to retrieve a metafile stored in a disk file. 
This routine returns the handle needed to play the metafile. 


D.1.4 Playing a Metafile 


To play a metafile, use the PlayMetaFile function call with the handle of the 
metafile that you want to play. 
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D.1.5 Deleting a Metafile 


To delete access to a metafile, use the DeleteMetaFile function. 
DeleteMetaFile disables the handle so that the application cannot play the 
metafile. Deleting a metafile frees the system resources associated with that 
file. 


D.1.6 Copying a Metafile 

Use the CopyMetaFile function to make copies of metafiles. To successfully 
copy metafiles between applications each application must contain a global 
definition of the metafile. 

D.1.7 Altering Metafiles During Playback 

You can use the EnumMetaFile function to alter a metafile during playback. 
EnumMetaFile allows you to control how the metafile is played. Otherwise 


GDI uses the PlayMetaFile function to play it exactly as it was created. 


With EnumMetaFile, GDI will call the playback function with every record in 
the metafile. This record may now be altered, copied, queried, etc. 


Any record can be played by using the PlayMetaFileRecord function. This 
includes records stored in the metafile you've specified, ones that have been 
altered, and newly created metafile records. See below for more information on 
the internal structure of metafile records. 


D.1.8 Object Manipulation 


Objects created during the playback of a metafile are identified by an index to 
an object table that contains the corresponding object handles. 
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Object selection calls use these indexes to identify the object to be selected. 
The objects are added to the table in the order they are created. For example, if 
a brush is the first thing created in the metafile -- by using one of the object- 
creation routines -- the resulting object is given index 0. The next object 
created is given index 1, and so on. 


The handle table is declared follows: 


typedef struct HANDLETABLE { 
HANDLE objectHandle[1]]; 
} HANDLETABLE; 


D.2 Metafile Data Structure 
The metafile itself is organized into two parts, a header and a list of records. 
The header contains a description of the size (in words) of the metafile and the 


number of drawing objects it uses. The list of records contains the GDI 
functions. The drawing objects can be pens, brushes, or bitmaps. 


D.2.1 Metafile Headers 


The following structured list describes the fields found in a metafile header: 


struct { 
WORD mtType; /* Metafile in memory = 0; on disk = 1 */ 
WORD mtHeaderSize; /* Metafile size in words */ 
WORD mtVersion; ' /* Version number in words*/ 
_DWORD mtSize; /* Size of file in words */ 
WORD mtNoObjects; /* Word vee raety number of objects created in 
metafile * 


DWORD mtMaxRecord; /* Size of largest record in words */ 
WORD mtNoParameters; /* This field is not used */ 


D.2.2 Metafile Records 


Metafile headers are followed by a series of records. Metafile records describe 
GDI functions. Most of the GDI functions that can be used to create metafiles 
are stored in similar records. These function numbers are listed in Table D.1. 


« 29 » 


MICROSOFT WINDOWS 2.0 SDK UPDATE 


The rest of the functions contain more complex structures in their records and 
are described in Section D.2.3. 


The following structured list describes the fields found in a metafile record: 


struct{ 

DWORD rdSize; /* Records size in words */ 

WORD rdFunction; /* Function number in words */ 

WORD rdParm{1]; /* N words coeeene ig function parameters ParmN, ..., 
Parml (with the function call defined as 
Function(hDc, Parml, ..., ParmN)) * 


} 


Table D.1 GDI Functions and Values 


Function Value 
Arc 0817H 
Chord 0830H 
Ellipse 0418H 
ExcludeCiipRect 0415H 
FloodFill 0419H 
IntersectClipRect 0416H 
LineTo 0213H 
MoveTo 0214H 
OffsetClipRgn 0220H 


OffsetViewportOrg 0211H 
OffsetWindowOrg 0Q20FH 


PatBlt 061DH 
Pie O81AH 
Rectangle 041BH 
RestoreDC 0127H 
RoundRect — 061CH 
SaveDC 001EH 


ScaleViewportExt 0412H 
ScaleWindowExt 0400H 


SetBkColor 0201H 
SetBkMode — 0102H 
SetMapMode 0103H 
SetMapperFlags 0231H 
SetPixel 041FH 
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SetPolyFillMode 0106H 
SetRelAbs 0105H 
SetROP2 0104H 
SetStretchBltMode 0107H 
SetTextAlign 012EH 
SetTextCharExtra 0108H 
SetTextColor 0209H 
SetTextJustification O20AH 
SetWindowExt 020CH 
SetWindowOrg 020BH 
SetViewportExt 020EH 
SetViewportOrg 020DH 


D.2.3 Miscellaneous Records 


Some metafile records contain data structures in the parameter field. The 
following pages contain definitions for these records. 


BitBlt Record 
struct } 

DWORD rdSize; 
WORD rdFunction; 
WORD rdParm([1]; 


ee op 


bmHeight 
bmWidthBytes 
bmPlanes 
bmBitsPixel 
bits 


ei 


CreateBrush Indirect Record 
struct { 
a DWORD rdSize; 
@ WORD rdFunction; 
porernnee rdParm; 


/* Record size in words */ 
/* Function number is 0922H */ 
/* Contains the following elements: 


High word of the raster operation 
Y-coordinate of the source origin 
X-coordinate of the source origin 
Destination y-extent 

Destination x-extent 

Y-coordinate of destination origin 
X-coordinate of destination origin 
Width of bitmap (in pixels) 

per aee of bitmap (in raster lines) 
Number of bytes in each raster line 
Number of color planes in the bitmap 
Number of adjacent color bits 
Actual bitmap bits 


/* Record size is seven words */ 
/* Function number is 02FCH */ 
/* Specifies the logical brush */ 
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CreateFont Indirect Record 

SUrucE. 4 . 

DWORD rdSize; /* Record size is 28 words */ 
WORD rdFunction; /* Function number is 0x02FBH */ 
‘aaa rdParm; /* Specifies the logical font */ 


CreatePatternBrush Record 
struc 
DWORD rdSize; /* Record size in words */ 
WORD rdFunction; /* Function number is Q1F9H */ 
WORD rdParm[1}; /* Field contains the following elements: 


omT ype Bitmap type 

bmi oth Bitmap wadeh 

bmHeight Bitmap height 
omWidthBytes Bytes per raster line 


bmP lanes Number of color planes 
bmBitsPixel Number of adjacent color bits that 
define a pixel 
bmBits | Pointer to bit values 
a bits Actual bits of pattern 


CreatePen Indirect Record 
struc 

DWORD rdSize; /* Record size is 8 words */ 
WORD rdFunction; /* Function number is 0x02FAH */ 
ree rdParm; /* Specifies the logical pen */ 


CreateRegion Record 

struct { 

DWORD rdSize; /* Record size in words */ 

WORD rdFunction; /* Function number is O6FFH */ 

ee rdParm[1]; /* Contains the region to be created */ 


DrawText 
struct { 
DWORD rdSize; /* Record size in words */ 
WORD rdFunction; /* Function number is 062FH */ 
WORD rdParm[1]; /* Contains the Ee ee information: 
ie 


Format Specifies method of formatting 

count Number of bytes in the string 

rectangle Rectangular structure defining area 
where text is to be defined 

string Byte array containing the string 


«/ (({count +1) >> 1) words long) 
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Escape Record 
Struct { ae es 
DWORD rdSize; /* Record size in words */ 
WORD rdFunction; /* Function number is 0626H */ 
WORD rdParm[(1]; /* Contains the following escape information: 
escape number Number identifying individual escape 


count Number of bytes of information 
input data Variable length field 
k/ (((count+1) /2+1) ) 
} 
ExtTextoOut 
struct { 
DWORD rdSize; /* Record size in words */ 
WORD rdFunction; /* Function number is 0A32H */ 
WORD rdParm; /* Contains the following elements: 
Vy ae a y-value of string's starting 
oin 
X ogical x-value of string'’s starting 
oin 
count String's length 
options Rectangle type 
rectangle RECT structure defining ExtTextOut 
rectangle if option is non-zero; non- 
existent if options equal zero 
string Byte array (((count + 1) >>1) words 
long) containing the string 
dxarray Optional word array of intercharacter 
distances 
a A 
} 
Polygon Record 
Struct <{ 
DWORD rdSize; /* Record size in words */ 


WORD rdFunction; /* Function number is 03248 */ 
WORD rdParm[l}; /* Contains the following elements: 
count Number of points 
list of points List of individual points */ 


Polyline Record 
struct { 


DWORD rdSize; /* Record size in words */ 

WORD rdFunction; /* Function number is 0325H */ 

WORD rdParm; /* Contains the following elements: 

count Number of points 
7 list of points List of individual points 

} 
SelectClipRegion 
struct { 

DWORD rdSize; /* Record size in words */ 


WORD rdFunction; /* Function number is 012CH */ 
WORD rdParm; /* Index into the handle table corresponding to the 
region being selected */ 
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SelectObject 
struct { 
DWORD rdSize; /[* 
WORD rdFunction; / 
WORD rdParm} /* 


} 

StretchBlt Record 
struct { 

DWORD rdSize; /* 


WORD rdFunction; /* 
WORD rdParm[1]; k 


x] 
} 
TextOut Record 
struct { 
DWORD rdSize; /* 


WORD rdFunction; /* 
WORD rdParm; / 


ss 


Record size in words */ | 

Function number is 012DH */ 

Index into the handle table corresponding to the 
object being selected */ 


Record size in words */ 
Function number is 0x0B23H */ 
Contains the following elements: 


raster op 
raster op 


DX 

bmWidth 
bmHeight 
bmWidthBytes 
omP lanes 
bmBitsPixel 
bits 


Low word of the raster operation 
High word of the raster operation 
Y-extent of the source 

X-extent of the source 

Y-coordinate of the source origin 
X-coordinate of the source origin 
Destination y-extent 

Destination x-extent 

Y-coordinate of destination origin 
X-coordinate of destination origin 
Width of the bitmap in pixels 

Height of the bitmap in raster lines 
Number of bytes in each raster line 
Number of color planes in the bitmap 
Number of adjacent color bits 

Actual bitmap bits 


Record size in words */ 
Function number is 0521H */ 


count 
string 
y-value 


x-value 


* Contains the following elements: 


The ea be length 
The actual string 

neg7ce: y-value of string's starting 
oin 

ogical x-value of string’s starting 
point 
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D.3 Sample Metafile Program 


This sample program will create a small metafile in which a purple rectangle 
with a green border is drawn, and the words "Hello People" are written in the 
rectangle. 


MakeAMetaFile (nDC) 
HDC hDC; 


HPEN hMetaGreenPen; 
HBRUSH hMetaVioletBrush; 
HDC hDcMeta; 

HANDLE hMeta; 


/* create the metafile with output going to the disk */ 
hDCMeta = CreateMetaFile( (LPSTR) "sample.met"); 


hMetaGreenPen = CreatePen(0, 0, (DWORD) Ox0000FF00); 
SelectObject (nDCMeta, hMetaGreenPen) ; 


hMetaVioletBrush = CreateSolidBrush({ (DWORD) Ox00FFOOFF) ; 
SelectObject (nDCMeta, hMetaVioletBrush); 


Rectangle (hDCMeta, 0, 0, 150, 70); 
TextOut (nDCMeta, 10, 10, (LPSTR) "Hello People”, 12); 


/* we are done with the metafile */ 
hMeta = CloseMetaFile (hDCMeta) ; 


/* play the metafile that we just created */ 
PlayMetaFile(hDC, hMeta); 
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The resulting binary file sample.met will look like this: 


il mtType... disk metafile 

9 mtSize... 

0 mtVersion 

0 0036 mtSize - 
2 mtNoObjects ¢ 
0 Od0Cc mtMaxRecord 
0 mtNoParameters 

0 

A 


0008 rdsSize 
rdFunction (CreatePen function call) 
0000 0000 0000 FFOO rdParm (LOGPEN structure defining pen) 


0004 rdsSize 
rdFunction (SelectObject) 
rdParm (index to object #0... the above pen) 


0007 | rdaSize 
rdFunction (CreateBrush) 
OOFF OOFF 0000 rdParm (LOGBRUSH structure defining the brush) 


0004 rdSize 
rdFunction (SelectObject) 
rdParm (index to object #1... the brush) 


0007 rdSize 
rdFunction (Rectangle) 
0096 0000 0000 rdParm (parameters sent to Rectangle... 
in reverse order) 


nwo ee Moo Come 2 wae Ea La 


a 
c= 


0 Q00C rasize : 
1 rdFunction (Text0Out) ¢ 

rdParm s 
C count 


string 
48 65 6C 6C 6F 20 50 65 6F 70 6C 65 “Hello People" 
O00A y~-value 
000A x~value 
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Microsoft Windows 
Programmer's Learning Guide 


CHAPTER 3 [Pages 21-52]: 
A Sample Application: Generic 


Create the C-Language Source File [Section 3.8.1; pages 46-48] 


The C-language source file must contain the WinMain function, the Generic 
WndProc window function, the About dialog function, and the GenericInit 
initialization function. Name the file generic.c and make sure it looks like this: 


finclude "windows.h" /* required for all Windows applications */ 
#include "generic.h" /* specific to this program x / 
HANDLE hInst; | /* current instance */ 
int PASCAL WinMain(hInstance, hPrevInstance, lpCmdLine, nCmdShow) 
HANDLE hInstance; /* current instance a] 
HANDLE hPrevinstance; /* previous instance kf 
LPSTR lpCmdLine; /* command line a) 
int nCmdShow; /* show-window type (open/icon) */ 
HWND hWnd; /* window handle */ 
MSG msg; /* message x / 
if (!hPrevInstance) /* Has application been initialized? */ 
| if ('GenericInit (hInstance) ) 
return (NULL); /* Exits if unable to initialize x / 
hinst = hiInstance; /* Saves the current instance “| 
hWnd = CreateWindow("Generic", /* window class xf 
"Generic Sample Bp aGae Toney /* window name x / 
WS OVERLAPPEDWINDOW, /* window style ® 
CW USEDEFAULT, /* x position x / 
CW USEDEFAULT, /* y position * | 
CW USEDEFAULT, /* width x / 
CW-USEDEFAULT, /* height x / 
LL, /* parent handle x / 
, /* menu or child ID */ 
hInstance, /* instance as 
LL); /* additional info */ 
if ('hWnd) /* Was the window created? */ 
return (NULL); 
ShowWindow (hWnd, nCmdShow) ; /* Shows the window kf 
UpdateWindow (hWnd) ; /* Sends WM PAINT message */ 
while (GetMessage(é&msg, /* message structure * | 
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NULL, /* handle of window receiving the message */ 
NULL x lowest message to examine x / 
NULLS ) /* highest message to examine +*/ 
Trans lateMessage (&msq) ; /* Translates virtual key codes */ 
DispatchMessage (emsq) ; /* Dispatches message to window */ 


} 
return (msg.wParam); /* Returns the value from PostQuitMessage */ 


} 
BOOL GenericInit (hInstance) 


HANDLE hInstance; /* current instance x / 
{ 
HANDLE sega /* handle to allocated memory */ 
PWNDCLASS pWndClass; /* structure pointer x / 


BOOL bSuccess; /* RegisterClass() result x / 


hMemory = LocalAlloc(LPTR, sizeof (WNDCLASS) ); 
pWndClass = (PWNDCLASS) LocalLock (nMemory); 


pWndClass->style = NULL; 

pWndClass->lpfnWndProc = GenericWndProc; 
pWndClass->hInstance = hInstance; 

pWndClass->hIcon = LoadIcon(NULL, IDI APPLICATION) ; 
pWndClass->hCursor = LoadCursor (NULL, IDC ARROW) ; 
pWndClass->hbrBackground = GetStockObject {WHITE BRUSH) ; 
pWndClass~>lpszMenuName = (LPSTR) NULL; - 
pWndClass->lpszClassName = (LPSTR) "Generic"; 


bSuccess = RegisterClass (pWndClass); 


LocalUnlock (hMemory) ; /* Unlocks the memery x / 
LocalFree (hMemory) ; /* Returns it to Windows 


return (bSuccess); /* Returns result of registering the window */ 


} 


[DELETE: " 
BOOL GenericInit (hInstance) 


‘uae hInstance; /* current instance x 
HANDLE uae /* handle to allocated memory */ 
PWNDCLASS pWndClass; /* structure pointer * |} 
BOOL bSuccess; /* RagisterClass() result x / 


hMemory = LocalAlloc(LPTR, sizeof (WNDCLASS) ); 
pWndClass = (PWNDCLASS) LocalLock (hMemory) ; 


pWndClass->style = NULL; 

pWndClass->lpfnWndProc = GenericWndProc; 
pWndClass->hInstance = hinstance; 

pWndClass->hIcon = LoadIcon(NULL, IDI APPLICATION) ; 
pWndClass->hCursor = LoadCursor (NULL, IDC ARROW) ; 
pWndClass->hbrBackground = Get Stock0bject {WHITE BRUSH) ; 
pWndClass->lpszMenuName = (LPSTR) NULL; ~ 
pWndClass->lpszClassName = (LPSTR) "Generic"; 


bSuccess = RegisterClass(pWndClass); "] 


BOOL FAR PASCAL About (hDlg, message, wParam, 1Param) 
HWND hD1lo; 

unsigned message; 

WORD wParam; 

LONG lParam; 


switch (message) { i 
case WM INITDIALOG: /* message: initialize dialog box */ 
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return (TRUE); 


ca 7 COMMAND: /* message: received a command */ 
f twParam = IDOK) { /* "OK" box selected? k 
EndDialo (ndig, NULL); /* Exits the dialog box x / 
return (TRUE); 
break; 
return (FALSE); /* Didn't process a message */ 


} 
aa Pe te wee GenericWndProc (hWnd, messa e, wParam, lParam) 


HWN /* window handle x f 
neta message; /* type of sae x7 
WORD’ wParam; /% sic ional information k / 
i lParam; /* additional information x / 
FARPROC lpProcAbout; /* pointer to the About function */ 
HMENU hMenu; /* handle to the System menu x] 


Switch (message) { 
st a SYSCOMMAND:  /* message: command from system menu */ 
£ (wParam == ID ABOUT) { 

lpProcAbout = MakeProcInstance (About, hInst); 
DialogBox (hInst, /* current instance ay 
"AboutBox", i resource to use wa 
hWnd, fe eee, handle x | 
lpProcAbout) ; bout () instance address */ 


Seta enue 
break; 


} 


else /* Lets Windows process it LF 
return (DefWindowProc (hWnd, message, 
wParam, lParam) ); 


case WM CREATE: /* message: window being created */ 
hMenu = GetSystemMenu (hWnd, FALSE); 
onan g re eAnnenu, /* menu handle k / 
ULL, /* menu item to change */ 
NULL, /* new menu item k / 
NULL, /* menu identifier * / 
MF APPEND | MF SEPARATOR); /* type of change x, 
ane eel /* menu handle x / 
/* menu item to change */ 
"Agbout Generic. /* new menu item x f 
ID ABOUT, /* menu identifier x | 
MF-APPEND | MF _ STRING) ; /* type of change x / 
break;— 
case WM DESTROY: /* message: window being destroyed */ 
post guat Message tuys 
break; 
. default: /* Passes it on if unprocessed * | 
‘® return (DefWindowProc (hWnd, message, wParam, 1Param)); 
os return (NULL); 
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CHAPTER 4 [Pages 53-66]: 
Output to a Window 


Creating, Selecting, and 
Deleting Drawing Tools [Section 4.3; pages 59-60] 


HPEN hDashPen; 


hDashPen = CreatePen (PS DASHED, 1, RGB (0, 0, 0)): 


Drawing and Writing [Section 4.4; pages 60-62) 


You can also display text by using the DrawText function. This function is 
similar to TextOut, except that it lets you write text on multiple lines. The 
following example displays the string "This long string illustrates the 
DrawText function" on multiple lines in the specified rectangle: 


RECT rcTextBox 
PSTR peor = "this long string illustrates the DrawText function"; 


SetRect (ércTextBox, 1, 10, 160, 40); 
DrawText (nDC, pText, strlen (pText) , &rcTextBox, DT LEFT); 


Modify the WM_ CREATE Case [Section 4.6.2; pages 63-64] 


case WM CREATE: 


hRedBrush = CreateSolidBrush (RGB(255, OF O)); 
hGreenBrush = CreateSolidBrush(RGB( 0, 255, SE 
hBlueBrush = CreateSolidBrush(RGB( 0, Uy 250) )2 
/* Create the "---" pen */ 
hDashPen = CreatePen (PS DASHED, {* ees x | 
' = /* width */ 
RGB(O, 0, 0)); /* color */ 
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/* Create the "..." pen */ 
hDotPen = CreatePen(PS DOTTED, [x st fet x / 
, — /* width */ 
RGB(0, 0, 0)); /* color */ 


hMenu = GetSystemMenu (hWnd, FALSE); 
ChangeMenu (hMenu, NULL, NULL, NULL, MF APPEND | MF SEPARATOR); 
ChangeMenu (hMenu, NULL, "A&bout Output?. .", ID_ABOUT, 
» ard | MF _STRING) ; 
reak; 


CHAPTER 7 [Pages 89-108]: 
The Cursor, the Mouse, and the Keyboard 


Using the Keyboard to Move the Cursor 
[Section 7.4.1; pages 98-100] 


POINT ptCursor; 


case WM KEYDOWN: 
if (wParam !'= VK LEFT ¢& wParam != VK RIGHT £& 
eee I= VK-UP £& wParam != VK DOWN ) 
reak; 7 


GetCursorPos (&ptCursor) ; 
ScreenToClient (hWnd, &ptCursor); 


Switch (wParam) { 
case VK LEFT: 
ee x “= 1; 


case VK RIGHT: 
tCirsor.x += 1; 
reak; 
case VK UP: 
Seen <yrs=s13 
reak 
case VK DOWN: 
pee yt= 1; 
reak; 


} 


ClientToScreen (hWnd, &ptCursor); 
SetCursorPos{ptCursor, x, ptCursor,y) ; 
break; 
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Add a Lengthy Operation [Section 7.5.5; pages 104-105] 


case WM CHAR: 
if (wParam == "\r!' 
SetCapture (hWnd) ; 


hSaveCursor = SetCursor (hHourGlass); 


hDc = GetDc (hWnd) ; 

TextOut (hDC, l, i "Calculating prime numbers...", 28); 
sprintf(str, "Calculated %d_ primes. ", sieve()); 
TextOut (nDC, 1, 1, str, strlen(str) ); 

ReleaseDC (hWnd, hDC); 


SetCursor (hSaveCursor); /* Restores previous cursor */ 
ReleaseCapture (); 


a 
break; 


Add the WM KEYDOWN Case [Section 7.5.7; pages 106-107] 


case WM KEYDOWN: 
Si pci geo e 
if (wParam ! FT ¢& wParam != VK RIGHT g& 
aa '= VK_UP && wParam != VK DOWN ) 
reak; 


ScreenToClient (hWnd, «ptCursor) j 
repeatt++; /* Increases the repeat rate */ 


switch (wParam) { 


case VK LEFT: 
tCtrsor.x -= repeat; 
reak; 


case VK RIGHT: 
tCursor.x += repeat; 
reak; 


case VK UP: 
poco -yY —= repeat; 
reak; 


case VK DOWN: 
pee -y t= repeat; 
reak; 


[DELETE: " 
default: 


return (NULL); "] 


GetClientRect (hWnd, «Rect); /* Gets the client boundaries */ 


if ({ptCursor.x >= Rect. ieee ie 
ptCursor.x = Rect.righ 
else if (ptCursor.x < Rect. lett) 
ptCursor.x = Rect.left; 
alga (ptcurso. -y >= Rect. bottom) 
Cursor.y = Rect. bottom - 1; 
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else if (ptCursor.y < Rect.top) 
ptCursor.y = Rect.top; 


ientT reen (hWn 
rsorP rsor,x rsor 


break; 


case WM KEYUP: 
Re repeat = 1; /* Clears the repeat count */ 
i ( break; 


CHAPTER 8 [Pages 109-129]: 
Menus 


Add an Edit Menu to the Resource File [Section 8.6.2; page 126) 


EditMenu MENU 
POPUP "&File" 
BEGIN 


END 

POPUP "eEdit" 

BEGIN 
MENUITEM "cUndo\ tALT+BKSP", IDM UNDO 
MENUITEM SEPARATOR x 
MENUITEM "Cueti\tShift+Del", IDM CUT 
MENUITEM "sCopy\tCtrl+Ins", IDM COPY 
MENUITEM "cPaste\tShifttins”, IDM PASTE 

a MENUITEM "Célear\tDel", IDM_CLEAR 


END 


CHAPTER 9 [Pages 131-156]: 
Bitmaps 


Modify the Make file [Section 9.4.11; pages 155-156] 


link4 bitmap, , , slibw[ DELETE: "/NOE"] select.lib, bitmap.def 
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CHAPTER 10 [Pages 157-183}: 
Controls and Dialog Boxes 


Moving and Sizing a Control [Section 10.2.6; page 162] 


MoveWindow (hButtonWnd, 10,10, 30,12, TRUE); 


Add a Constant to the Include File _ [Section 10.9.1; page 168) 


fin _EDI 


Creating a Dialog Function _ [Section 10.10.3; page 174) 


The WM_INITDIALOG message, sent to the dialog box just before it is ¢ 
displayed, gives the dialog function the opportunity to give the input focus to 
any control in the dialog box. If the function returns TRUE, Windows will set 

the input focus to the control of its choosing. [DELETE: "Since there is only | 

one control in this dialog box, the dialog function lets Windows set the input 

focus. "] 


CHAPTER 12 [Pages 205-225]: 
Printing 


Add the IDM PRINT Case {section 123.3; page 220-2211 ¢ 


To carry out the printing operation, you need to add an IDM_PRINT case to 
the main window function. Add the following statements: 
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case IDM _ PRINT: 
hPr Nl 
if (‘hp r) 


sprintf (str, "Cannot print 7s", FileName); 
MessageBox (hWnd, str, NULL, MB OK | MB "TCONQUESTION) ; 
return (NULL); 


} 
lpAbortDlg = MakeProcInstance(AbortDlg, hiInst); 
ve lpAbortProc = MakeProcInstance(AbortProc, hInst); 
@ Escape (hPr, SETABORTPROC, NULL, 
(LPSTR} (long) lpAbortProc, (LPSTR) NULL); 
if (Escape (hPr, Pt 4, "PrntFile text", 
LPSTR) NULL) < 
Nessagesox (hing, "Unable to start print job", 
MB OK | MB ICONQUESTION); 
FreeProcinstance (AbortD1g) ; 
FreeProcInstance (AbortProc} ; 
DeleteDC (hPr); 
r n (NULL); 


} 


bAbort = FALSE; /* Clears the abort flag */ 

hAbortDlgwWnd = CreateDialog(hInst, "Abort Dig", hWnd, lpAbortDlq); 

EnableWindow (hWnd, FALSE) ; 

GetTextMetrics (hPr, éTextMet ric) ; 

LineSpace = TextMetric.tmHeight + TextMetric. See ae t 

Escape (hPr, GETPHYSPAGESIZE, NULL, (LPSTR) NULL, (LPSTR) 
&PhysPageSize) ; 

LinesPerPage = PhysPageSize.y / EN Gees ce; 

dwLines = endMessage hEdi twin, EM GETLINECOUNT, 0, OL); 


CurrentLine = 
for ({dwindex = rostatus = 0; dwIndex < dwhines; dwindext+) { 
Bel = at /* Maximum buffer size */ 
ine = 


ineLength = "SendMessa e(hEditwWnd, EM GETLINE, 
(WORD) au Tne (LONG) ((LPSTR) pline)); 
TextOut (hPr, 0, CurrentLine*LineSpace, (LPSTR) pLine, LineLength) ; 
if (++CurrentLine > LinesPerPage yee 


[DELETE: "Escape (hPr, NEWFRAME,, 0, OL, OL); "J 


CurrentLine = 
TOStatus = Escat e(hPr, NEWFRAME, 0, OL, OL}; 
if (I0Status < || bAbort) 

break; 


} 
} 


if (IOStatus >= 0 && !bAbort) { 
Escape (hPr, NEWFRAME, 0, QL, OL); 
Escape (hPr, ENDDOC, 0, OL, OL); 


} 

EnableWindow (hWnd, TRUE); 
Dest royWindow (hAbortDlqWnd) ; 
FreeProcInstance (AbortDlg) ; 
FreeProcInstance (AbortProc) ; 
DeleteDC (hPr); 

break; 
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CHAPTER 13 [Pages 227-248]% 
The Clipboard 


Selecting and Copying Bitmaps 
to the Clipboard (Section 13.2.4; pages 235-237] 


The following statements are necessary to tell the application what to do when a 
user chooses the Copy command: 


case ID COPY: 
hDC7= GetDC (hWnd) ; 
PatBlt (hDC, OrgX, Orgy, 
eon Widt 
CopyHeight 
NVERT) ; 
hMemoryDC = (hDC) ; 
if (hMemoryDC != NOLL 
eres ee = Te et matibtettnap Oe, 
ee cory yey eight); 
if ibe map != 
hOldBitmap = Selectob ject (nMemoryPC, hBitmap) ; 
ale ese ae != NULL) 
BitBlt (nMemoryDC, 0, Q, nob 
hdc, eal Org! SRCCO 
pp maP SelectObjec i1dBitmap) ; 
aby ey '= NULL && Seno Es ard (hwnd) { 
oy EyS ipboard(); 
C ipboardData (CF_ BITMAP, hBitmap) ; 
“lose ipboard(); 


nee CopyHeight, 


} 
} 
DeleteDC (hMemoryDC) ; 
ReleaseDC (hWnd, hDC); 
EnableMenultem(hMenu, ID COPY, MF GRAYED) ; 


OrgX = OrgY = CopyWidth = CopyHeight = 0; 
break; 
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Modify the WM_INITMENU Case | [Section 13.5.2; pages 245-246] 


cee WM INITMENU: 
(wParam == Get Menu (hWnd) ) { 
wrormat = 
if (Cpencl apars (nnd) { 
ile ((wFormat = a age ge te ea accra 
j && wrormat != CF BITMAP); 
closeclipboard) 
if (wFormat == CF BITMAP) 
EnableMenultemi (wParam, ID PASTE, MF ENABLED) ; 


“pnableMenultem (wParam, ID PASTE, MF GRAYED); 


} 
if (IsRectEmpty (SelectRect) ) 
EnableMenultem(wParam, ID COPY, MF GRAYED) ; 


se 
EnableMenulItem(wParam, ID COPY, MF ENABLED) ; 
return (TRUE); 


else 


APPENDIX A [Pages 251-268]: 
Fonts 


Creating a Logical Font [section A.5; page 256] 


This logical font asks for a fixed-pitch font in which each character is ten pixels 
high and eight pixels wide. [DELETE: "Font dimensions are always 
described in pixels.""] Anywhere a user refers to font height or width, it is in 
user units. The requested escapement and orientation are zero, which means 
the baseline along which the characters are displayed is horizontal and none of 
the characters will be rotated. FW_NORMAL is the requested weight. Other 
typical weights are, FW_BOLD (for darker, heavier characters) and 
FW_LIGHT (for lighter characters). Italic, underlined, or struckout characters 
are not desired. The requested character set is ANSI, the standard character set 
of Windows. Default output precision, clipping precision, and quality are 
requested. These attributes affect the way the characters are displayed. Setting 
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these attributes to default values lets the display device take advantage of its 
own capabilities to display characters. The requested font family is 
FF_MODERN. The font name is "System". 


Getting Information 
About the Selected Font [Section 13.2.4; pages 235-237] 


TEXTMETRIC TextMetric; 


sly 4A aie Ue 


GetTextMetrics(hDC, &TextMetric); 
nLineSpace = TextMetric.tmHeight + TextMetric.tmExternalLeading; 


Y = 0; 
for Gi= 0p 2 ae ot 
TextOut (nDC, Q, Y, 


) { 
"Single-line spacing", 19); 
Y += nLineSpace; 


} 


Creating Font-Resource Files | [Section A.13; page 265) 


Note 
You should not add fonts to an application's resources. Resources 


in an application's resources are reserved for use by the application 
only. 
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APPENDIX B [Pages 269-281]: 
Memory Management 


Using the Local Heap [Section B.2.2; pages 273-274] 


You should also check the address returned by the LocalLock function. This 
function returns NULL if the memory handle was not valid or if the contents of 
the memory block have been discarded. 


The DATA Segment | [Section B.3.2; page 278) 


A large-model application may have additional data segments, but only one 
DATA segment. In Windows, any additional data segments must be explicitly 
defined in the SEGMENTS statement of the module-definition file and must 
be fixed. Fixed data segments are not recommended, so it is preferrable to use 
medium models for applications. 
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Microsoft Windows Programming Tools 


CHAPTER 2 [Pages 9-22]: 
Cl, Pascal, and the Macro Assembler 


Segment Names _ [Section 2.2.6; pages 14-15] 


When compiling medium-, compact-, and large-model source files for 
Windows applications, you must specify the names of the code and data 
segments to which the given source belongs. You specify the names by using | 

tions -NT for cod d-ND for data. If the options are not used, the C 
compiler assumes that the source belongs to the standard code and data 
segments, TEXT and DATA. 


Stack Probes [Section 2.2.7; page 15] 


Unless the -Gs option is given, the C compiler inserts a stack probe in each 
function. A stack probe is code that checks the stack to make sure that it has 
sufficient space for the local variables declared within the function. If the stack 
would overflow, the code calls the FatalExit function and terminates 
Windows. Stack probes can be used in Windows applications and libraries. 
Since libraries use the stack of the caller, a stack probe in a library function 
checks the caller's stack. Use the - tion durin lication development. 


Packed Structures [Section 2.2.10; page 15] 
All Windows functions that use structures use packed structures. A packed 


structure is any structure in which the extra bytes typically used by the C 
compiler for padding have been removed. Windows applications that use 
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structures with Windows must use the -Zp option to direct the compiler to pack 


structures on single-byte boundaries, 


Windows and C-Language Libraries [Section 2.2.11; page 16} 


After your application sources have been compiled, you must link the object 
files with the appropriate C-Janguage libraries for Windows and C run- -time 


and libw. lib) contain code for the Windows application startup routes and 
references for the Windows functions. 


libc. lib, clibe.li d Ilibce lib ode for outa s calle b the 

indow routines a n-time functions used by the 
lication. Which C-I ave libraries you link with depends on your 
lication's programming model and whether or not the model uses floating- 


point support. 


For example, a small-model application must be linked with the small-model 
library slibw.lib. Although you must use the Windows linker, link4, to link 
r application, the C compiler adds default li information to your 
lication's object files. so the only libr need to specify in the link4 
mmand line is the appropriate C-language library for Windows. For more 


information about linking, see Chapter 4, "Windows Linker: Link4." 


C Run-time Functions [Section 2.2.13; page 17] 
[In the third paragraph:] 


Although Windows applications can call C run-time memory-allocation 
functions, such as malloc and calloc, the linker replaces these calls with 
appropriate calls to Windows memory-management functions, such as 
LocalAlloc. Windows memory-management functions are similar but not 


‘identical to the C run-time functions, so care must be taken when using the C 


memory-management functions in your applications. 
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Coprocessor/Emulator Math Option [Section 2.2.14.1; page 18] 


You choose the coprocessor/emulator math option by specifying -FPi on 
the compiler command line. Your program will then automatically be linked 


m cnc hide winS7em ‘b on your link command line, and make sure en 
e winS7em.exe library module can be fo on the search path when the 
lication is loaded. 


ion canter 7al- wine lon sie f 


Pro s that use the -FPi option will automatically take advantage of a math 
TOC r 7/80287/8 if one is available. If there is no coprocessor 
vailable, th lication's floating-point emulator simulates the operation of the 
coprocessor. 


Alternate Math Option [Section 2.2.14.2; page 18] 


Y an choose the alternate m tion by specifving -F Pa on the compiler 
command line. Your program will be linked automatically with either slibca.lib 
or mlibca.lib (be sure these libraries are available). 


Example 


cl -c -~FPa -AS -Gsw -0Os she sample.c 
Link4 sample, /al:16,/map,slibw, sample.def; 
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CHAPTER 3 [Pages 23-69]: 
Resource Compiler: Rc 


Introduction [Section 3.1; Page 25] 
[In the second paragraph: ] 


This chapter describes how to create a resource script file and how to compile 


your application's resources. All Windows 2.0 applications must pass through 
the new resource compiler (re version 2.0), even if they don't have any 
resources. 


Compiling Resources [Section 3.3; pages 28-30] 


Option Descripti 
Ir Creates a .res file from a .rc file. 
-] Creates an application that uses the Lotus Intel Microsoft 
Expanded Memory Specification, Version 3.2. 
-e Creates a driver library that uses expanded memory. 


-) or -h Displays this list of options. 


The filename parameter specifies the name of the script file that contains the 
names, types, filenames, and descriptions of the resources you want to add to 


the file. It can also specify the name of a compiled .res file, in which case the 


appende e executable file. 
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ACCELERATORS Statement [Section 3.8; pages 35-36] 


Syntax 

acctablename ACCELERATORS 

BEGIN 

vent . idvalu e INVERTIIA HIFT TROL 
END 


{After third paragraph on page 36:} 


Th ion, if given S lerator to be activa’ nly if the ALT 
key is down. 


STYLE Statement [Section 3.10.1.1; page 43] 
[Before "Comments" section:] 


All edit controls in dialog box memory outside the application's data 
segment. This feature may be suppressed by adding the DS LOCALEDIT 
flag to the Style command for the dialog in the rc file. If this flag is not used, 
EM GETHANDLE and EM SETHANDLE messages must not be used since 
the storage for the control is not in the application's data segment. This feature 


esn fe dit con re utsi f dialog box 
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CHAPTER 4 [Pages 71-89]: 
Windows Linker: Link4 


Introduction [Section 4.1; page 73] 
[In the first paragraph:] 


You create executable Microsoft Windows applications and libraries by linking 
your compiled source files using the link4 program. The link4 program takes 
your compiled sources, a list of [DELETE: "Windows and other" ] libraries, 
and a module-definition file (a text file containing information about your 
application or library) and creates a file that you can load and run with 
Windows. 


[New third paragraph:] 


utility that may enable you to relink your Windows applications much faster. 


For more information about ilink, see the Microsoft CodeView and Utilities 
dat 


Linking an Application [Section 4.4; page 85] 


You can link the compiled application source files, the libraries, and the 
module-definition files by using link4, the Windows linker. The link4 program 
combines the code and data of all application files with the appropriate code for 
any Windows functions called from within the application, and creates a new 
executable file, 
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Link4 Command _ [Section 4.4.1; pages 85-86] 


Example 


link4 sample/al:16,sample.exe, sample.map/map/1li,slibw,sample.def 


Link4 Options [Section 4.4.2; pages 86-88] 


/alignment: size 


/map 


This option directs link4 to align segment data in the 
executable file along the boundaries specified by size. The 
size parameter specifies a boundary size in bytes; for 
example, "alignment:16" indicates an alignment boundary 
of 16 bytes. [DELETE: "The recommended alignment for 
Windows applications is 16 bytes."] The size parameter 
must be a power of 2; therefore, 2, 4, 8, 16, and so on are 
appropriate values. The default is 512 bytes. Minimum 
abbreviation: /al, 


Note that the recommended alignment for Windows 
applications is 16 bytes: the 512-byte default wastes disk 
space. . 


This option directs link4 to create a map file, which is 
used by mapsym to create a .sym file. The .sym file is then 
ed he symbolic debugger, sym 


/nodefaultlibrarysearch 


This option causes link4 not to use the default C run-time 
libraries. Minimum abbreviation: /nod. 
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/noextendeddictionarysearch 
This option prevents link4 from searching a library's 
extended dictionary, which is a list of symbols stored in the 
library. Link4 normally consults this list to speed up 
library searches. Link4 issues an error message if this 


witch is needed, Minimum abbreviation: /noe. 


[DELETE: 

"/packcode[:number] 
This option directs link4 to pack contiguous logical or 
memory-code segments into one physical or file segment. 
The number parameter specifies the size limit of the 
segment in bytes. If no number is given, the default is 
65,536. Minimum abbreviation: /pac. ""] 

[DELETE: 

"/stack:size This option directs link4 to set the stack size to size bytes. 


This option is typically used in place of the STACKSIZE 
statement in the module-definition file. Minimum 
abbreviation: /st.""] 


[In note on page 88:] 


[DELETE: 

"There is an additional option, /nodefaultlibrarysearch, which causes link4 to 
ignore default libraries. Some language compilers, such as the Microsoft C 
Compiler, add default-library information to the object file. To ensure that the 
necessary library information is added to your application's object files, do not 
use this option." ] 
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The following switches not wed when linking Window lications: 


/overlayinterrupt 


The following switches are not recommended when linking Windows 
applications: 


/nogroupassociation 
/packcode 
/stack (Set the stack size in the .def file instead) 


For more information regarding linking options. see the Microsoft C 5.0 User's 


Guide. 


CHAPTER 5 [Pages 91-138}: 
Symbolic Debugging Utility: Symdeb 


Symdeb Commands | [Section 5.9; pages 110-113) 


[In Table 5.1:] 


df Dump list of global free blocks 
dm Dump list of loaded modules 
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dq Dump list of current tasks, their SS:BP, CS: IP, nEvents, 
priority. module name, and queue handle 


du Dump list of discardable object 


Annotate each stack frame with the associated br oint 
value 


R 


Breakpoint Address Command _ [Section 5.9.5; page 119) 


The size parameter specifies the size of the data that symdeb expects to find 
read or written at the given address[DELETE: "; the breakpoint will be taken 
only if the data has that size". If B is specified (8-bit byte), the command will 
break only at one address (for example, 0:10). If W is specified (16-bit word), 
the command will break at one of two addresses within that range (for example, 
0:10 or 0:11 will cause a break within that word). If D is specified (32-bit 
double-word), the command will break at one of four addresses within that 
range (for example, 0:08, 0:09, 0:10, or 0:11 will cause a break within that 
double-word). 


CHAPTER 8 [Pages 179-192]% 
Icon Editor 


Starting Icon Editor [Section 8.2; pages 181-182} 
The menu bar lists the menu names at the top of the window. You can select a 


menu by pointing to the name and clicking the left mouse button. Icon Editor 
has the following menus: 
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Choosing Resolution _ [Section 8.4.2; pages 184-185] 


Delete the entire section, and replace it with the following: 


8.4.2 Device Dependence 


rsors. bitma icon xist in two different forms: device-dependent 


and device-independent. The need for these different forms exists because 


most lications must be able to run on different systems with different 
resolution displays. If objects such as icons. cursors, and bitmaps are going t 
appear similar in si ross the different displays. they need to be designated 


as device-independent objects. ¢ 
8.4.2.1 Device-independent Objects 


Device-independent objects have a fixed resolution when created. Icons have a 


resolution of 64x64 pixel rsors h 2X32 pixels bitm e user 
defined. These specifications provide enough resolution so that the object 
a rrectly on 1024x1024 pixel displays. When a device-independen 

iect is loaded into Windows, it is scal ropriately for the device bein 
used. 
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For example vice-independent icon would be scaled from 64x64 pixels to 


32x32 pixels when loaded into a system with an EGA high-resolution display. 
The same icon would be scaled to 32x16 if loaded into a system with aCGA 
display. Device-independent bitmaps are scaled by the same factor as icons 
and cursors. 


Device-dependent objects are objects that are created for a display with a 

specific resolution. When creating device-dependent objects, you must specify 

the resolution of the object. For icons and cursors there are three resolutions to 
hoose from. each listed in the New Figure dialog box. For bitmaps you must 


specify the x and y dimensions. 


Device C enden ob) ects not scaled b Wind ws when loaded, Sinc 


icon ursor rarel sedi Bitma S Rowee r oft Annie as 


device-dependent so that the bits will not be scaled. 
4 he ,i m r Fil 


When an icon (ico). bitmap (.bmp), or cursor (.cur) is saved to a file, the 
devic -inde endent version 1 ula say d Lh st of the ie. If c ob} ect 


then appended to the file. The resource aie eee which version of the 
object to load from the file. 


The device-independent version of the object is always saved so that if the 
object is edited and saved as a lower resolution, device-dependent object. Icon 
Editor doesn't lose the original resolution, 
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Working with Bitmaps _ [Section 8.4.3; page 185] 

[Fourth paragraph:] 

[DELETE: "You can choose the Discardable checkbox to make your bitmap 
discardable. This means that if the application needs more memory to run, it 


can discard the bitmap. Keep in mind tha if the application does discard the 
bitmap, the bitmap will have to be loaded again if it's needed again." ] 


Driver Dependence [Section 8.4.4; page 185] 


Delete the entire section. 


Changing the Pen Color _ [Section 8.5; pages 185-186] 
[Second paragraph:] 


The Color menu lists four pen colors: White, Black, Screen, and Inverse 
Screen. An icon or cursor pixel with Screen color has the same color as the 
screen pixel underneath it. Inverse Screen is the inverted color; an icon or 
cursor pixel with Inverse Screen color has the color that is the opposite of the 
screen color. For example, if the screen is white, the pixel is black; if the screen 
is light blue, the pixel is red. 
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Small [Section 8.6.1; page 186] 

For instance, if the pen color is black and the screen color is light blue, this is 

what happens when you're using the Small pen size: 

* Pointing to a pixel and clicking the left mouse button turns the pixel black. 
Clicking the same pixel again turns it white. 


* Pointing to a pixel and clicking the right mouse button tums the pixel light 
blue. Clicking the same pixel again tums it red. 


Medium, Large, and Extra Large [Section 8.6.2; page 187] 

When you choose the Medium, Large, or Extra Large pen size, the pointer 
looks like a thin brush when it's in the drawing box. The mouse buttons do not 
toggle. For example, if the pen color is set to black and the background color is 
set to light blue, this is the effect when you're using the Medium, Large, or 
Extra Large pen size: 


* Pointing to a pixel and clicking the left mouse button turns that pixel and 
the pixels around it black. Clicking the same pixel again has no effect. 


* Pointing to a pixel and clicking the right mouse button turns that pixel and 
the pixels around it light blue. Clicking the same pixel again has no effect. 


Changing the Background Color _ [Section 8.8; page 188] 


Delete the entire section. (See new Section 8.13, "Using the Options Menu." ) 
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Using the Options Menu [Section 8.13; new section] 


13.1 Gri n raight Lin 


A visible grid drawn on the drawing box by selecting Grid from th 
Options menu. The rectangles created by the grid lines represent individual 
pixels in the object. To remove the grid, select Grid again. 


13,2 Chaneing the B roun lor 


You can change the background color of the drawing box and the display box 
by using the Options menu. The Options menu lists four background colors: 
Black, White, Dark Blue, and Light Blue. To change the background color, 
choose the desired color command from the Options menu. Icon Editor re- 
displays the drawing box and display box with the new background. 


It is important to understand that the background color is used only for 
viewing. Changing the background color does not change what 1s stored in the 
n. cursor. or bitma file. Thus. ou.us back ound olor see Dow an 


colo test thi for iorthe deonto Vou lication 


When you open anew icon or cursor file, all the pixels in the file are Screen 
pixels. You create an icon or cursor by drawing pixels in the pen color. Kor 
icons and cursors, you have a choice of four pen colors: White, Black, Screen, 


and Inverse Screen. To see how these look on different backgrounds, you can 
hoose f the four backeroun lors. 


Bitmaps. however, can have only white or black pixels. en you open anew 
bitmap. all the pixels are white. Since there cannot be an reen or Inverse 


Screen pixels in bitmaps, the background color does not matter. The 
ack und loris shown only in t e displa x, outside th ea of th 
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lay Resoluti 


By defaul icon editor displ 1 in the resolution of the display bein 


used: for instance, medium resolution for an EGA high-resolution display. 
’ e However, items in the Options menu allow an object to be displayed as it will 


appear on ale uses a different resolution 


If you would like to see what the current object would look like on a different 
device. choose the resolution you want from the Options menu. The object in 


the display box will be shown as it would look on a display that has th 
resolution you've chosen. This feature is most useful for displaying device- 
independent objects. Note that you cannot display a device-dependent object in 
a higher resolution than the resolution that was used when the object was 
created, 


2 CHAPTER 10 [Pages 213-236]: 
¢@ Dialog Editor 


Introduction [Section 10.1; page 213] 


* Create and modify the include file associated with the dialog boxes being 


edited 
The .A files that Di Editor ontain onl fine statements; Dialo 
Editor saves onl fine statements. If old .} files are used, and they contain 
any information other than #define statements, none of the other information 
will be saved. 
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Starting Dialog Editor [Section 10.2; pages 216] 


Menu Contents 
File Commands that create, open, and save .dig and .res files. 


There is also a command that allows you to select a dialog 
box from the current .res file for editing. 


Include Commands that you_use to create, modify, or view an 
include file. 


Edit : Commands that allow you to perform common editing 
| functions such as cutting and pasting. There are also 
commands for creating a new dialog box, renaming an 
existing one, changing the style and text of a control, and 
moving groups of controls as a unit. 


Control Commands that let you select the type of controls to be 
placed in the dialog box, 


Options Commands that let you define the order in which controls 
are accessed. test your dialog box. and align controls on a 
grid. 

[DELETE: 

"Styles Commands that allow you to control the styles, text, and ID 


values for the dialog-box controls. There is also a 
command for defining memory management." ] 
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— Using the Status Window [Section 10.3; pages 217-218] 


When you start Dialog Editor, you will notice a small window labeled 
"Selected Item Status" in the lower-right corner of the screen. The Status 
window stays on your screen ou edit a dialog box and supplies you with 
information about the dialog box and the controls in it. When you make a 
change to the dialog box or controls, the change is reflected in the Status 
window. If necessary. the Status window can be moved out of the way of a 
dialog box you are working on. 


The Status window displays the information shown in the following list. All 
size/position values are in dialog units. (A dialog unit is a horizontal or vertical 
distance. One horizontal dialog unit is equal to 1/4 of the width of a character in 
the system font. One vertical dialog unit is equal to 1/8 of the height of a 
character in the system font.) 


Field ripti 

X Displays the position on the x-axis (vertical position) of the 
upper-left corner of the dialog box or control you have 
selected. 

y Displays the position on the y-axis (horizontal position) of 
the upper-left corner of the dialog box or control you have 
selected. 

CX Displays the height of the dialog box or control you have 
selected. 

Cy Displays the width of the dialog box or control you have 
selected. 
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[DELETE: 

"Work/test mode Indicates whether Dialog Editor is in Work mode, in which 
you can edit the dialog. box, or Test mode, in which you can 
try out the controls in the dialog box. 


[Decimal/Hex Indicates whether the ID values for the controls are shown <¢ 
in decimal or hexadecimal numbers." ] 


Control Shows the type of control you have selected (for example. 
Radio Button or Check Box). If the dialog box itself was 
selected, rather than a control, this part of the Status 
window will read "Dialog Box." 


ID Value Shows the ID value of the control you have selected. The 


ID value is displayed either as a number or as a symbol 
from SOCI include file. If the dialo xX W 


selected, no ID value is shown. 


Clearing the Display [Section 10.4.1; page 218] ( 


Dialog Editor clears the display, removing any existing dialog box. If you have 
previously made changes to the existing box, you will see a dialog box asking 
whether you want to save the changes. [DELETE: "The New command 
opens anew file called sample, which is initially empty." ] 


Adding Text to Controls [Section 10.5.2; page 221] 


To add or change the text in a control, follow these steps: 


[DELETE: | ¢ 
"1. Select the control by clicking inside it." ] 
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1. Double-click the control. (You m so choose Styles from the Edi 
menu.) You will see a dialog box showing style information about the 
control. 


Ie 


In the Text box, type the text you want to have appear in the control. You 
can type more text than will fit in the text box. If you want to edit what you 
have typed, you can use the DIRECTION keys to move the insertion pomt, 
and then add text at the insertion point. To delete characters, use the 
BACKSPACE key. 


3. Choose the OK button or press the ENTER key to confirm your entry. (The 
Control Styles dialog box has other uses, which are described in Section 
10.6.1.) 


Note 


When you add an Icon control to a dialog box, the text should be 
the name that was defined for the icon in the .rc file. For example, 
assume that the .rc file contains the following entry: 


myicon icon my.ico 


To use this icon in adi x, you would create an Icon control 
and type the name "myicon" in the Text section, 
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Moving a Group of Controls [Section 10.5.4; pages 222-223) 


You can move a group of controls from one location in a dialog box to another. 


This can be useful if you decide to rearrange the layout of controls in the box 
and you have two or more controls that you want to keep together. To move a 
group of controls, follow these steps: 


1. Choose "Group Move" from the Edit menu. 


2.__select each control you want to keep in the group by using the mouse 
utton. Each control will be outlined with a gray line: the group of control 


will also have a gray border around it. If you change your mind, you can 


verse a Selection licking it again with mouse button 


[Figure 10.4 Pointer Position for Moving a Group of Controls] 


4,_ Press and hold down the mouse button 


. Drag the f controls to the desired location and release the mouse 
on. Th of controls is placed in the new location 


Changing Control Styles and Memory-Manager Flags 
[Section 10.6; page 223] 


Th 1 mmand in Edit menu allow set control styles an 
memory-m r fl 


whe r ut nis faul sh tton 
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Changing Control Styles {Section 10.6.1; page 224] 


The Styles command in the Edit menu allows you to change the control styles 
that govern a control. You can also use this command to enter or change text in 


a control and to change the control's ID value. (If an include file was loaded, 
you may symbolically refer to the control's ID value. For more information on 
include files, see Section 10.10.1.) 


To change a control style for a specific control, follow these steps: 


[DELETE: 
"1. Select the control." ] 


1. Double-click the control to be modified. (You may also choose Styles 
from the Edit menu.) You will see a dialog box that relates to the control 
you Selected, similar to the dialog box shown in Figure 10.5: 

[Figure 10.5 Button Control Styles Dialog Box] 


2. Select the desired options. Control-style options are described in Chapter 3, 
"Resource Compiler: Rc." 


3. Choose the OK button or press the ENTER key. 


Changing Standard Styles [Section 10.6.2; pages 224-225] 


Delete the entire section. 


Including a System-Menu Box, 
a Size Box, or Scroll Bars [Section 10.6.3; page 226] 


Delete the entire section. 
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Setting Memory-Manager Flags [Section 10.6.4; pages 226-227] 


The Memory-Manager Flags command in the Edit menu allows you to set 
memory-manager flags for your dialog box. Memory-manager flags determine 
how the code for a dialog box is treated by the application and by Windows 
with regard to memory. You can set options to specify when a resource is to be 
loaded into memory, as well as whether the resource is fixed or moveable and 
whether it is discardable. 

To set memory-manager flags, follow these steps: 


1. Select the dialog box you are working on. 


2. Choose the Memory-Manager Flags command from the Edit menu. You 
will see the dialog box shown in Figure 10.7: 


[Figure 10.7 Memory-Manager Flags Dialog Box] 
3. Turn on (or off) the check boxes corresponding to the memory-manager 
flags you want. (These options are described in Chapter 4, "Windows 


Linker: Link4.") 


4. Choose the OK button or press the ENTER key. 


Setting a Tab Stop [Section 10.7.2; page 229] 

Tab stops determine where the pointer will move when the user presses the 
TAB key. Normally, tab stops are set for individual controls or, in the case of a 
group, for the first control in the group. To set a tab stop, follow these steps: 


1. Choose Order Groups from the Options menu. 


2. In the list box, select the control at which you want to place the tab stop. 
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el Tab Stop button in the Group/Control Ordering dialog box. An 


asterisk appears next to the control, which indicates that a tab stop has been 
placed there. 


4. Repeat Steps 2 and 3 for each control requiring a tab stop. 


3. Choose the OK button or press ENTER. 


[DELETE: 

" Note 

You can can also set a tab stop by selecting the control, choosing Standard 
Styles from the Styles menu, and then turning on the Tab Stop Bit check 
box." ] 


Deleting a Tab Stop [Section 10.7.3; pages 229-230] 


[DELETE: 

@ " Note 

. You can also delete a tab stop by selecting the control, choosing Standard 
Styles from the Styles menu, and tuming off the Tab Stop Bit check box." ] 


Adding a Group Marker _ [Section 10.7.4; page 230] 


[DELETE: 

" Note 

You can also add a group marker by using the Standard Styles command from 
the Styles menu. Select the control, then turn on the Group Bit check box. A 
group marker will be placed just above the control you selected." ] 
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Deleting a Group Marker _ [Section 10.7.5; pages 230-231] 


[DELETE: 

" Note 

You can also delete a group marker by selecting the control, choosing Standard 
Styles from the Styles menu, and turning off the Group Bit check box." ] 


Using the Edit Menu [Section 10.9; page 232] 


[DELETE: 

"Grid Determines the location of the upper-left corner of a 
control. The grid is defined in multiples of dialog units. 
For example, when the grid is set at 20 horizontal (dx) units 
and 20 vertical (dy) units, the numbers defining the position 
of the control's upper-left corner will be in multiples of 20. 
Default settings are one dialog unit each in both horizontal 
and vertical directions." ] 


Include File [Section 10.10.1; pages 233-234] 
[In the third paragraph:] 
ID Value of I 


When the ENTER, CANCEL, or ESCAPE key is pressed, Windows automatically 
sends a response message to the dialog-input function. If the dialog box has a 
default button (for example, the OK button), pressing the ENTER Key sends a 
WM_COMMAND message, along with the ID value of the default button. 
Thus, if you have a default OK button, you should assign it an ID value of 1, so 
that it will be activated when the user presses the ENTER key. This is consistent 
with the recommended guidelines for creating a Windows application. (For 
information on application guidelines, see the Microsoft Windows Application 
Style Guide.) 
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CHAPTER 11 [Pages 237-244]; 
Shaker and Heapwalker 


Testing Movable Memory: Shaker _ [Section 11.2; pages 239-240] 


In Table 11.1, the State menu is now called the Display menu. The Shake menu 
no longer exists; Start, Stop, and Step are now menu names, on the menu bar 
(even though they function as commands); their actions remain the same. 


Figure 11.1 should show the following names in the menu bar (with the 
indicated letters underlined as mnemonics): 


Parameters Display Start Stop Step 


Viewing the Global Heap: Heapwalker 
{Section 11.3; pages 241-244] 

[In Table 11.2, after "Walk Heap," page 241:] 

Walk LRU List 
Walk Free List 


GC(0) and Walk Performs a global compact without discarding any blocks, 
then displays the global heap. 


GC(-1) and Walk 
Performs a global compact, discarding all discardable 


blocks, then displays the global heap. 
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[In Table 11.2, after "Free xK of allocated memory," page 242:] 


Set Swap Area This command is used to set low-memory situations. By 
making the swap area larger, the amount of memory 
available for code is increased, while memory available for = 
data is greatly reduced. This command is particularly é 
effective when used in conjunction with (prior to) the 
Allocate all of memory command to simulate low-memory 
situations. 


Segmentation Test 


Dumps the heap to file hw6.xx (where the extention .xx is 
an incremental number nded by the pro d does 
a global compact (-1). This command is available when- 
ever Heapwalker is in the system, even if it is not the active 
application: it can be accessed through the keyboard equiv- 
alent that Heapwalker installs (CONTROL+SHIFT+ALT), 


This f allows the user to run Heapwalker as an icon 

h_a series of segmentation tests inspect th 

Its later. The k d equivalent isn’ ilable when 
running EMS memory, 


{In Table 11.2, after "Module," page 242:] 


Size Sorts the display by module size. 


Label Segments Dir Heapwalker to look in the current dir 


mbol tabl rresponding to the modules it finds, I 
n h le information ment label 
inst f numbers, next ments 


[In Table 11.2, after "Show Bits,” page 242:] 


Discard Attempts to discard the ntly selected memory block. e 
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Ides Makes the currently selected object the next candidate for 
discarding. 
Newest Makes the currently selected object the last candidate for 
discarding, 


CHAPTER 12 [New Chapter]: 
Snap 


12.1 Introduction 


The Microsoft Snap utility copies bitmaps of application windows to the 
Clipboard. The bitmap in the Clipboard can then be pasted into any application 
that will accept bitmap input. For example, both Microsoft Windows Write and 
Paint will accept bitmap input. 


In Microsoft Windows, you use the Clipboard to hold information being 
copied or moved. For complete information regarding Clipboard, see the 
Microsoft Windows User's Guide. 


Note 


If you have trouble copying a bitmap in color, you can run 
Windows and Snap in black and white. To do this you can either 
modify your WIN.INI file manually, or use Control Panel. For 
information on changing screen colors, see the Microsoft Windows 
User's Guide. 
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12.2 Starting Snap 


Snap is a Windows utility. To start Snap, open the MS-DOS Executive. Make 
sure at least part of the window to be copied is visible on the screen. Start 
Snap by double-clicking the filename snap.exe. 


12.2.1 Copying a region of a screen 


To copy a region of the screen, follow these steps: 


1. 


Zi 


Choose Select region when snapping from the Option menu. 


Make sure the entire region to be copied is visible on the screen. You may 


need to move the Snap window out of the way. 


Click Snap! on the menu bar. The pointer turns into a hand holding a set of 
cross hairs. 


Drag the mouse to select the region to be copied. When you release the 
mouse button, the region is copied to the Clipboard. 


12.2.2 Copying the client area of a window 


To copy the client area of a window, follow these steps: 


1. 


Zi 


3. 


Choose Select window when snapping from the Option menu. 
Choose the Activate and bring to top option. 
Choose the Exclude non-client area option. 


Click Snap! on the menu bar. The pointer turns into a pointing finger. 


. Click anywhere in the window to be copied. A copy of the client area now 


resides in Clipboard. 
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12.2.3 Copying an entire window 

To copy an entire window, follow these steps: 

1. Choose Select window when snapping from the Option menu. 

2. Choose the Activate and bring to top option. 

3. Click Snap! on the menu bar. The pointer turns into a pointing finger. 


4. Click anywhere in the window to be copied. A copy of the window now 
resides in Clipboard. 


12.2.4 Quitting Snap 


You can quit Snap by choosing Exit from the Options menu, or by double- 
clicking the Control-menu box. 
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Microsoft Windows Extensions 


APPENDIX B [New appendix]: 
Windows Write Binary File Format 


A Write binary file consists of three parts: The header, the text and picture part, 
and the formatting information. 


B.1 Header Portion © 


The header contains "magic words" and pointers to the subdivisions of the 
formatting section as well as information about the length of the file: 


Word Meaning 
0 wldent Must be 0137061 octal 
1 dty Must be 0 
2 wTool Must be 0125400 octal °° 3BO4 =) 
3 Reserved; must be 0 
4 Reserved; must be 0 
5 Reserved; must be 0 
6 Reserved; must be 0 
7..8 fcMac # of bytes of actual text PLUS 128 — 
(bytes in one sector) [low order word 
first] 
9 pnParal Page number? of start of 
PARAGRAPH info 
10 _ pnFntb Page number of FNTB (or pnSep if 
none) | | 
11 pnSep Page # of SEP (or pnSetb if none) | 
12 pnSetb Page # if SETB (or pnPegtb if none) 7] | 
13 pnPetb Page # of PGTB (or pnFfntb if none) | 
14 pnFfntb2 Page # of FFNTB (or pnMac if none) 
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16..47 szSsht Not used by WRITE; reserved for 
WORD compatibility 

A8 pnMac3 Count of pages in whole file (last page 
number + 1) 


1. pnChar, the starting page # of CHARACTER info, is not stored, but is 
computable: pnChar = (fcMac + 127) / 128. 


2, A "page number" as referred to above means an offset in 128-byte chunks 
from the start of the file. e.g. a pnPara of 10 means the para info is at offset 
10 X 128 = 1280 in the file. 


3. In Word files, word 14 of the header is pnMac, and word 48 (pnFfntb in 
Write files) is 0. Examining the value of word 48 of the header is a good 
way to tell Write files from Word files. 


B.2 Text and Picture Portion 


The text of the file starts at word 64 (page 1). It is ANSI (ASCII + characters 
above 128) text (except for pictures) with the following restrictions: 


- PARAGRAPH ENDS are stored as <Return><Linefeed> (ASCII 13, 10 
dec.). No other occurrences of these two characters are allowed. 

- Explicit PAGE BREAKS are stored as ASCII 12. 

- Other line breaks or WORD WRAP information is not stored. 

- TAB characters are ASCII 9 (normal). 


B.3 Pictures 
Pictures are stored as a sequence of bytes in the text stream. These bytes are 


recognizable as picture information by looking at their paragraph formatting. 
One picture is exactly one paragraph. Paragraphs that are pictures have a 
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special bit set in their PAP structure (see the description of the paragrph 
formatting part of the file later on in this document). 


Each picture consists of a descriptive header, followed by the bytes of the 
bitmap or metafile that make up the picture. The picture header is as follows: 


Byte Meaning 

9 mfp Windows METAFILEPICT structure! 
(hMF field undefined). 

6..7 dxaOffset Offset of picture from left margin, in 

| twips (1/1440 inch) 

8..13 Reserved; must be 0. 

14..27 bm Windows BITMAP structure! (bmBits 
field undefined), not defined for 
metafiles. 

28..29 cbHeader Number of bytes in this header. 

30..33 cbSize Number of following bytes (actual 
metafile or bitmap bits). 

34.35 mx Scaling factor (x)2. 

36..37 my Scaling factor (y)*. 

38..cbHeader-1 Reserved for future use. 

cbHeader.. Picture contents. 


..cbHeader+cbSize-1 


1. See windows.h and the Windows Programmers’ Guide and Reference 
Manual. 


2. If the picture has never been rescaled with the WRITE Size Picture 
command, the scaling factors in each direction will be 1000 (decimal). If the 
picture has been resized, the scaling factor will be the percentage of the 
original size that the picture now is, relative to 1000 equalling 100%. 


3. These bytes will be bitmap bits if the mm field of the mfp structure (bytes i] | 


0..1) is 99 (decimal) (this is a special value used within WRITE only); 
metafile contents otherwise. 
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B.4 Formatting Portion 
B.4.1 Character and Paragraph 


Both the character and paragraph sections are structured as a set of pages. Each 
page has the following format: 


Byte Meaning 

0..3 fcFirst Byte # in file of first character covered 
by this page of formatting information. 
(The byte # of the first character in the 
text is 128.) [Low order byte first.] 

Al rgfod An atray of FOD's (see below). 

i+1.. erpfprop A group of FPROP's (See below). 

126 
127 cfod Number of FOD's on this page 


The structure of each FOD (FOrmat Descriptor) is as follows: (these are fixed 
size) 


Word nin 

0..1 fcLim Byte # AFTER last character covered 
by this FOD. 

Z bfprop Byte offset from beginning of rgfod to 


corresponding FPROP for these 
characters or this paragraph. 


The structure of each FPROP (Formating PROPerty) is as follows: (these are 
variable size) 
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Byte Meaning 
0 cch 
lon rgchProp 


Number of bytes in this FPROP. 

A prefix of a CHP (for characters) or a 
PAP (for paragraphs) sufficient to 
include all bits which differ from the 
standard CHP or PAP. 


Here is the format of a CHP (CHaracter Property): 


Byte Bit 
0 
1 0 
1 
ey 
2 
3 0 
1 
2 
3 
4.5 
6 
7 
4 0..2 
3 
4 
5.7 


nin 


Reserved; ignored by WRITE. 
fBold Characters are bold. 
fItalic Caracters are italic. 
ftc Font code (low bits); an index into 
the FENTB. 

hps Size of font in half pts (standard is 
24 dec.). 

fUline Characters are underlined. 

fStrike Reserved; ignored by 
WRITE. 

fDline Reserved; ignored by 
WRITE. 

fOverset Reserved; ignored by 
WRITE. 

csm Reserved; ignored by 
WRITE. 

fSpecial Set for "(page)" only. 

Reserved; ignored by WRITE . 

ftcXtra Font code (hi bits, 
concatenated with ftc). 
fOutline Reserved; ignored by 
WRITE 
fShadow Reserved; ignored by 
WRITE. 
Reserved; ignored by WRITE. 


84 » 


MICROSOFT WINDOWS 2.0 SDK UPDATE 


hpsPos 0 for normal; 1..127 for 


superscript; 128..255 for 
subscript 


The standard CHP has byte 0 = 1, byte 2 = 24, all other bytes = 0. 


Note, therefore, that each character FPROP must have acch of at least 1. 


Here is the format of a PAP (PAragraph Property): 


Byte — Bit 

0 
0..1 
Ad | 

2 

3 

4..5 

6..7 

8..9 

10..11 

12..13 

14..15 

16 0 
1.21 
3 
4 
5..7 

17.21 


« 


Meanin 


Reserved; must be 0. 
Justification: O=left, 
1=center, 2=right, 3=both. 


Reserved; must be 0. 


Reserved; must be 0. 
Reserved; must be 0. 


dxaRight Right indent in 20ths of a 
point. 

dxaLeft Left indent in 20ths of a 
point. 

dxaLeftl First line left indent" " " 
" " (relative to dxaLeft). 

dyaLine  Inter-line spacing" " " " 
" " (standard is 240 dec.) 

dyaBefore Reserved; ignored by 
WRITE (standard is 0) 

dyaAfter Reserved; ignored by 
WRITE (standard is Q). 

rhcPage O=header, 1=footer. 


Reserved; 0=normal para, non- 


zero=header or footer para. 


rhcFirst 1=print on 1st page, 
O=don't. 

fGraphics 1=paragraph is a picture, 
O=paragraph is text. 


Reserved; must be 0. 
Reserved; must be 0. 
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22..78 Up to 14 TBD's (tab spots; see 
below). 

TBD (TaB Descriptor): 

Byte Bit Meaning 

0..1 dxa Indent from left margin of tab stop 
(in 20ths of a point) 

Z Q..2 jcTab 0 for normal tabs; 3 for 
decimal tabs 

3.55 | tlc Reserved; ignored by WRITE 
6.7 Reserved; must be 0 

3 chAlign Reserved; ignored 

by WRITE 


The standard PAP has byte 0 = 61 dec., byte 2 = 30 dec., bytes 10-11 = (word) 
240 dec., all other bytes=0. Note, therefore, that each paragraph FPROP must 
have cch >= 1. 


In constructing the pages of formatting information, there is a difference 
between paragraph and character FOD's. A character FOD may describe any 
number of consecutive characters with the same formatting. However, there 
MUST BE EXACTLY ONE PARAGRAPH FOD PER TEXT 
PARAGRAPH. In either case, it is allowable, and encouraged, to have 
multiple FOD's point to the same FPROP on a given page. No FOD may 
point off its page. 


There must be no "holes" in either the character or paragraph formatting 
information; each must begin with the first text character (byte 128) and 
continue through the last. Therefore, the last character FOD and the last 
paragraph FOD must have fcLim = fcMac as defined in the header. 


1. Write files have all of their header and footer paragraphs at the beginning of 
the document. All header and footer paragraphs appear prior to any normal 
paragraphs. When reading files created by Word, WRITE wil lonly g | 
recognize those headers and footers that appear at the beginning of the . 
document; all others will be treated as normal text. 
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B.4.2 Footnotes & Sections 


WRITE documents do not have a footnote table G.e., pnFntb is always equal to 
pnSep). 


@ A WRITE document has only one section. If the section properties of a 
WRITE document differ from the defaults, the document will contain a SEP 
section and a SETB section. If not, then neither section is present and pnSep 
and pnSetb are both equal to pnPgtb. 


The format of the SEP (SEction Property) is as follows: 


Byte nin 
0 cch Count of bytes used, EXCLUDING 
this byte. All properties at byte 
positions greater than cch will be set to 
their standard values. 
| ae Reserved; must be 0. 
e 3..4 yaMac Page length in 20ths of a point 
- (standard is 11*1440=15840). 
5..6 xaMac Page width in 20ths of a point 
(standard is 8.5*1440=12240). 
7..8 Reserved; must be FFFF hex. 
9..10 yaTop Top margin in 20ths of a point 
(standard is 1440). 
11..12 dyaText Height of text in 20ths of a point 
(standard is 9*1440=12960). 
13..14 xaLeft Left margin in 20ths of a point 
(standard is 1.25*1440=1800). 
15..16 dxaText Width of text area in 20ths of a point 


(standard is 6*1440=8640). 


So we have yaTop + dyaText + (bottom margin, not stored) = yaMac, and 
xaLeft + dxaText + (right margin, not stored) = xaMac. 
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Note that if all of the above properties are standard, no SEP or SETB is needed 
at all. Otherwise, we have 1 <=cch <= 16. 


The structure of the SETB (SEction TaBle) section is as follows: 


Word Meaning 
0 csed Number of sections (always 2 for 
WRITE documents, see below) 
1 csedMax Undefined. 
22) resed Array of SEDs plus 0-padding to fill 
| the sector. 


The structure of a SED (SEction Descriptor) is as follows: 


Word nin 

0..1 cp Byte address of first character 
following section. 

2 fn Undefined. 

3..4 fcSep Byte address of associated SEP. 


WRITE documents always have exactly 2 SED entries, with the first's cp 
indicating that it affects all of the characters in the document and its fcSep 
pointing to the one SEP in the file. The second SED entry is a dummy, with 
fcSep == FFFFFFFF (hex). 


The PGTB section [optional] is on the page immediately after the SEP section. 
NOTE: Contrary to the usage in the rest of this document, the term "page" 
used in the rest of this section refers to printed pages of a WRITE document, 
not 128-byte “pages” of a disk file. 
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The structure of the PGTB (PaGe TaBle) is as follows: 


Word nin 

0 cpgd Number of PGDs (1 or more). 

1 cpgdMac Undefined. 

25h rgpgd Array of PGDs plus 0 padding to fill 


the sector. 


The structure of a PGD (PaGe Descriptor) is as follows: 


Word Meaning 
0 pgn Page number in printed word 
documents. 
1.2 cpMin Byte address of first character in 
printed page 
§ B.4.3 Font Table 


The structure of the FFNTB (Font Face Name TaBle) is as follows: 
Byte nin 


0..1 cffn Number of FFNs. 
20 erpffn List of FFNs. 
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The structure of an FFN (Font Face Name) entry in the grpffn is as follwos: 


Byte Meaning | | 
0..1 cbFfn! Number of bytes in this FFN (NOT 
including these 2). 
2 ffid2 Font Family ID (see below). 
3..cbffin+2 szFfn Font name (variable length; 0- 
terminated) 


1. AcbFfn value of FFFF (hex) means that the next FFN entry will be found 
at the start of the next 128-byte page. A cbFfn value of 0 means that there 
are no more FEN entries in the table. 


2. Possible values for ffid are FF_DONTCARE, FF_ROMAN, FF_SWISS, 
FF_MODERN, FF_SCRIPT, FF DECORATIVE. 


These are full constants defined in WINDOWS.H. Additional values may 
be added to the list in future versions of Windows. 


APPENDIX C_ [New appendix]? 
Windows 2.0 Paint File Format 


The Microsoft Windows 2.0 Paint File Formats consist of three parts. The 
header describes the contents of the bitmap. It occupies the first 32 bytes of 
information in the file. 
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The index follows the header. The index is a table containing the number of 
bytes in the run-length code of each scanline. The run-length code itself 
follows the header. 


The following pages describe the three components in greater detail. 


C.1 Header 


The first bytes (0 - 31) contain the header information. The following structure 
defines the header. Each byte is described further in the paragraphs that follow 
the structure. 


typedef struct 


WORD ScrAspectX; 
WORD ScrAspectyY; 
WORD PrnAspectX; 
WORD PrnAspectY; 
WORD dxPrinter; 
WORD dyPrinter; 
WORD AspCorx; 
WORD AspCory; 
WORD wCheck; 


WORD resl; 
WORD res2; 
WORD res3; 
} FILEHDR; 


C.2 Header Definitions 


(0-1) 


keyl: 
Must contain 0x6144 


(2-3) 


key2: 
Must contain 0x4D6E 


(4-5) 


dxFile: 
This contains the size of the bitmap in x direction (in pixels). 
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(6-7) 
dyFile: 
This contains the size of the bitmap in y direction (in pixels). 


(8-9) 
SrcAspectX : 


This is the aspect ratio of the screen that this paint file was created for. 


values are obtained from GetDeviceCaps(hScreenDC, ASPECTX). 


(10-11) 
SrcAspectY: 


This is the aspect ratio of the screen that this paint file was created for. 


values are obtained from GetDeviceCaps(hScreenDC, ASPECTY). 


(12-13) 
PrnAspectx: 


This is the aspect ratio of the printer that this paint file was created for. 


values are obtained from GetDeviceCap(hPrinterDC, ASPECTX). 


(14-15) 
PmAspectY: 


This is the aspect ratio of the printer that this paint file was created for. 


values are obtained from GetDeviceCap(hPrinterDC, ASPECTY). 


(16-17) (18-19) 
dxPrinter: dyPrinter: 


These 


These 


These 


These 


These fields contain the resolution of the printer that this paint file was created 


for. The resolution is indicated by the number of pixels in the x and y 


directions on the printer. Please note that the numbers will vary according to 


the paper and printer mode selections. 


(20-21) (22-23) 
AspCorxX: AspCory: 


These two fields aren't used now and are set to zero. 
(24-25) 


wCheck: 
Check sum field. Make sure that this file is in paint format. 
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(26-31) 

Reserved:. 

These fields are reserved. 
resl 

res2 

res3 


C.3 Index 


Paint bitmaps are run-length encoded and each scanline is encoded separately. 
The length of the resulting encoded string depends on the pattern of the bitmap. 


An index table follows the header and each index entry corresponds to a single 
scanline. Index entries are unsigned integers and indicate the length of the 
encoded data. 


The index table occupies bytes 32 - xxx in the paint file. 


2-Xxx xxx = 32 + sizeof(unsigned int) * dyPrinter. 


C.4 Algorithm for Encoding 

Encoded data follows the index table. Paint file encoding is read in bytes and 
there are two types of encoded data. One type starts with zero, and the other 
starts with a value other than zero. The non-zero value can range from 1 to 
255. 

If the first byte is 0, the data is a repeated byte pattern. The byte after 0 
indicates the number of times the pattern is to be repeated. The third byte 
defines the pattern itself. For example, 

0 Ox80 Oxff 


should be expanded to 80 (in hex) bytes of Oxff. 
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If the data starts with a value other than zero, say 30, then the following 30 
bytes will contain unmodified bitmap data, without a recognizable pattern. In 
these instances, the encoded bytes following the non-zero value must replicate 
exactly the random bitmap pattern. 


Each scanline can be composed of several repeating and random groups of 
data. You might start a scan line with a repeat pattern, follow it with a random 
pattern, and then use another repeat pattem. You don't need to alternate data 
groups in a scanline though. You can have two repeated patterns next to each 
other representing different repeating patterns. 


The following example shows a scanline with alternating data groups. 


eee 40 ------- > <----- 30) -----> <--- 20) ---> 


The first data group in the above example would be encoded as follows: 
0 40 255 


(repeat pattem) (#of repetitions) (pattern - 255 
represents white) 


The second group would look like this: 
30 
(no repeat) (replica of exact bitmap) 
And the last group would be encoded as: 
0 20 0 


(repeat pattern) (# of repetitions) (pattern - 0 represents 
black) 
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The index for this scanline would be computed as follows: 


0 40 255 = 3 bytes 
30 _ (exact bitmap replica) = 31 bytes 


0 20 0 


And the entry in the index table would contain.......... 37 bytes 


3 bytes 


In order to locate the data for the nth scanline, add the number of bytes in the 
index table from entry 0 to entry n - 1, to locate the number of bytes that 
scanlines 0 to (n- 1) occupy. Then you will be at scanline n. 


APPENDIX D_ [New appendix}: 
Windows Calendar File Format 


This document describes the file format for the Windows Calendar program 
supplied with the retail version of Windows up through version 1.03. 


D.1 The Header 


The first 8 bytes are a character array which identify the file as a calendar file. 
This array contains: 


'C'+'r=b5 
‘Al +/a' = a2 
'L' + ‘d’ = b0 
'E' + ‘n' = b3 
'N' + 'e' = b3 
'D' +'l' = b0 
‘A’ +'a' = a2 
'R' +'c' =b5 
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The next 2 bytes contain the integer count of dates described in the file. 
(cDateDescriptors) 


The next 12 bytes contain 6 two byte fields of information that is global to the 
entire file. These variables are normally set by the user through the Alarm 


Controls and Options Day dialog boxes: 4 
WORD MinFarlyRing; /* early ring in minutes */ 
BOOL fSound; /* whether alarms should be audible 
int interval; /* interval between appointments: 
0 = 15 minutes 

1 = 30 minutes 

2 = 60 minutes */ 
int mininterval; /* the interval in minutes */ 
BOOL f£24HourFormat; /* TRUE for 24 hour format, 0 
otherwise */ 
int StartTime; [x starting time in Day Mode, i.e. 

the time that normally appears first 


in the display, in minutes past 
midnight / . 


The rest of the first 64 bytes are reserved. 


D.2 The Date Descriptors © 


The date descriptor array appears next. Each entry in the array describes one 
day. cDateDescriptors (described above) is the number of entries in the array. 
Each element in the array consists of 12 bytes, in 6 two byte fields as follows: 


unsigned Date; /* the date, in days past January 
BOOL ' fMarked; /* true if the date is marked */ 

int cAlarms; /* number of alarms set for the day ? 
unsigned FileBlockOffset; /* file offset, in 64 byte 


blocks, of where the day's 
information is stored. only the low 
15 bits are used (the high bit will 
be 0). Thus, if this offset were 
equal to 6, the day's information 
would be sotred at byte 6*64 in the 
ile. 

int. reserved; /* this equals Oxfff */ 

unsigned reserved; /* this equals Oxfff */ 
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D.3 Day Specific Information 


All day information is stored after the Date Descriptor array, on even 64 bytes 
boundaries. Day information is stored as follows: 


unsigned reserved; /* this must equal 0 */ 
unsigned Date; /* in days past 1-1-80 */ 
unsigned reserved; /* this must equal 1 */ 
unsigned cbhNotes; /* the number of pues of note 
information, including the null. 


This information appears in the note 
a ae the appointment list. */ 


unsigned eo eneent count of bytes of appointment 


information 
char Notes [cbNotes]; /* the text info of the note */ 
BYTE ApptInfo []; /* the block of appointments */ 


D.4 Appointment Specific Information 


The information in the appointment block is stored as a list of single 
appointments. Each appointment consists of the following fields: 


char cBytes; /* the count of bytes in the 
appointment, e.g. the next 
ae eagl a info will be at & 
Si isAppt.cBytes) + ThisAppt.cBytes 


char flags; /* the low bit controls the alarm 
(1 = alarm), while bit 1, if set, 
oe that it is a special time 


int Time; /* in minutes past midnight */ 

char ApptDesc[]; /* a null terminated string which 
contains the text associated with an 
appointment * 
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